Commit Graph

464 Commits

Author SHA1 Message Date
Andrea Luzzardi
acc593f388
Merge pull request #1961 from sestegra/doc
Update install procedure to support Homebrew on Linux
2022-03-31 15:17:01 -07:00
Andrea Luzzardi
b82d7200da
Merge pull request #1966 from TomChv/fix/export-cache
Fix export cache issue
2022-03-31 11:52:18 -07:00
Tom Chauveau
19c0f999f4
Fix export cache issue
Resolve #1551 and #1020.
We are never returning the result of solved operations so Buildkit could not
cache the layer.
This commit implements a simple system to forward operations' result to the
main build to cache it.

Signed-off-by: Vasek - Tom C <tom.chauveau@epitech.eu>
2022-03-31 20:36:50 +02:00
jffarge
9189b5cb20 use h2 title instead of h3 + fix code css
Signed-off-by: jffarge <jf@dagger.io>
2022-03-31 19:55:03 +02:00
Gerhard Lazu
64cdadb85e
Merge pull request #1963 from slumbering/docs-index
Display getting started as the index page
2022-03-31 15:41:06 +01:00
Tanguy ⧓ Herrmann
a7fa4d674e
doc: remove the bash syntax highlighting
it was highlighting the wrong keywords (test, do)

Signed-off-by: Tanguy ⧓ Herrmann <tanguy@dagger.io>
2022-03-31 16:16:02 +02:00
jffarge
095d4a327b Display getting started as the index page
Signed-off-by: jffarge <jf@dagger.io>
2022-03-31 15:53:25 +02:00
Stéphane Este-Gracias
b8756fb709
Update install procedure
Signed-off-by: Stéphane Este-Gracias <sestegra@gmail.com>
2022-03-31 13:45:31 +02:00
abserari
76a0e737a2 Docs Update:1200-local-dev.md build/index.html -> _buld/index/html
Signed-off-by: abserari <abserari@gmail.com>
2022-03-31 19:42:07 +08:00
Adrien Brault
12257ce53f docs: add getting started gitlab ci configuration
Signed-off-by: Adrien Brault <adrien.brault@gmail.com>
2022-03-30 23:46:12 +02:00
Helder Correia
995881ffb5
doc: Improve wording on “Go on Docker Hub” use case
Signed-off-by: Helder Correia <174525+helderco@users.noreply.github.com>
2022-03-30 16:37:07 +00:00
guillaume
f6bd78a3ca Go on Docker Swarm
Updates the `Go on Docker Swarm` use case to europa config. Diagrams are also included for better UX

Signed-off-by: guillaume <guillaume.derouville@gmail.com>
2022-03-30 18:23:42 +02:00
Tanguy ⧓ Herrmann
f57c42246c
update references to alpha.dagger.io
Signed-off-by: Tanguy ⧓ Herrmann <tanguy@dagger.io>
2022-03-30 15:08:45 +02:00
Gerhard Lazu
994ee22a6e
Fix Go on DockerHub id & filename + remove from sidebar
ID 1216 was clashing with docker-cli-load doc.

The filename follows the convention of the other use cases.

Remove from docs sidebar until we do the quick fixes.

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-30 00:45:09 +01:00
Sam Alba
9f196ca14f
Merge pull request #1929 from samalba/docs-cli-telemetry
docs: added a page about CLI telemetry
2022-03-29 16:22:17 -07:00
Sam Alba
23f34b50a0 docs: added a page about CLI telemetry
Signed-off-by: Sam Alba <samalba@users.noreply.github.com>
2022-03-29 14:15:10 -07:00
Gerhard Lazu
4d7026895d
Update dagger version in all docs to 0.2.4
Including the version that we install explicitly.

Fixes https://github.com/dagger/dagger/issues/1908

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-29 19:41:59 +01:00
Gerhard Lazu
9ba8b58dcd
Merge pull request #1884 from slumbering/issue#1761-docs-comments
[Docs] - content comments
2022-03-29 11:42:01 +01:00
jffarge
8af0bb7847 make sentence clearer
Signed-off-by: jffarge <jf@dagger.io>
2022-03-29 12:36:48 +02:00
Gerhard Lazu
19d762c5dd
Simplify Europa Docs sidebar
- move Dagger 0.1 references to the top
- move Dagger CUE API under Core Concepts, after What is CUE?
- move Go on Docker Swarm under Use Cases

A few minor title changes:
- Dagger CUE API (0.2+) -> Dagger CUE API
- What is Cue? -> What is CUE?

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-29 00:14:34 +01:00
Gerhard Lazu
2a6b91cf72
Merge pull request #1805 from TomChv/doc/add-go-use-case
Docs: Add dagger golang use case
2022-03-28 23:52:59 +01:00
Gerhard Lazu
695206ee66
Merge pull request #1869 from dagger/shykes-doc-misc
docs/1203: keep code sample on topic
2022-03-28 23:48:25 +01:00
Gerhard Lazu
9cda86f6f8
Update the version in docs to next release
This also accounts for dagger.io/dagger/core split introduced in
https://github.com/dagger/dagger/pull/1866

We should hold this merge until we are ready to cut the release,
otherwise links & some instructions will be broken until we release
v0.2.3.

Even though I would have preferred to have docs/update-version.sh in
Dagger, this is the quickest thing for now.

Related to https://github.com/dagger/dagger/issues/1854

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-28 22:23:51 +01:00
Helder Correia
d771699df9
Move connecting socket to client: network
Signed-off-by: Helder Correia <174525+helderco@users.noreply.github.com>
2022-03-28 18:16:07 +00:00
Helder Correia
6a2bbc62e0
Rename dagger.#Service to dagger.#Socket
Signed-off-by: Helder Correia <174525+helderco@users.noreply.github.com>
2022-03-28 17:56:25 +00:00
jffarge
d7ddf315d9 remove unecessary comment. Instead use Github review
Signed-off-by: jffarge <jf@dagger.io>
2022-03-28 12:05:15 +02:00
jffarge
c4b16b91e1 apply more comments
Signed-off-by: jffarge <jf@dagger.io>
2022-03-28 12:03:31 +02:00
jffarge
162e70cfd3 apply comments from Emily ggdocs
https://docs.google.com/document/d/1XolFtIzUMQQNOE6NNNO7JDmxECbj1uwjCcXv1SWVfeo

Signed-off-by: jffarge <jf@dagger.io>
2022-03-28 11:56:07 +02:00
Helder Correia
b3bdd347e7
Move core actions to a subpackage
Signed-off-by: Helder Correia <174525+helderco@users.noreply.github.com>
2022-03-27 17:33:47 +00:00
Solomon Hykes
11586abfdc
docs/1203: keep code sample on topic
Shorten one of the code samples, keeping only the part that speaks to the topic in the docs.
2022-03-26 21:47:37 -07:00
Solomon Hykes
9f042800da
Merge pull request #1860 from gerhard/europa-docs-plan-tanguy-fresh-pair-of-eyes 2022-03-26 12:45:13 -07:00
Helder Correia
770acd3ce2
Expand user home dir in client filesystem
Signed-off-by: Helder Correia <174525+helderco@users.noreply.github.com>
2022-03-25 20:25:36 -01:00
Helder Correia
05d79e8ba6
Add docker cli package
Signed-off-by: Helder Correia <174525+helderco@users.noreply.github.com>
2022-03-25 18:24:33 -01:00
Andrea Luzzardi
4f440bc67a
Merge pull request #1842 from helderco/docker-load
Add export and load for dagger images
2022-03-25 12:22:40 -07:00
Gerhard Lazu
3a6d922a4e
Follow-through the other "." → "./" & build → "./_build" renames
Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-25 16:55:23 +00:00
Gerhard Lazu
5fe04d22e9
Revise Europa Docs - Core Concepts - It all starts with a plan
Thank you Tanguy for the "fresh pair of eyes" perspective.

Thank you Tom for the link suggestions.

Supersedes https://github.com/dagger/dagger/pull/1847

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-25 16:25:24 +00:00
Helder Correia
7a8153910c
Add export and load for dagger images
Signed-off-by: Helder Correia <174525+helderco@users.noreply.github.com>
2022-03-25 15:04:29 -01:00
Gerhard Lazu
6db19fcea2
Allow any published dagger version to be installed via install.sh
This also updates Getting Started - CI/CD in your local dev - Linux & Mac doc.
A few other related doc changes were pulled in by this.

I wanted to try different versions of dagger on Linux, and this was the
easiest way of doing that:

    curl -L https://dl.dagger.io/dagger/install.sh -O
    # make this change, and then:

    DAGGER_VERSION=0.2.0 sh install.sh
    # ...
    ./bin/dagger version
    dagger 0.2.0 (e499297e) linux/amd64

    DAGGER_VERSION=0.2.1 sh install.sh
    # ...
    ./bin/dagger version
    dagger 0.2.1 (69b4845d) linux/amd64

This change enables anyone to do the following instead:

    curl -L https://dl.dagger.io/dagger/install.sh \
    | DAGGER_VERSION=0.2.0 sh

Until this gets merged, you can test how this change works in practice
via this temporary file:

    curl -L https://dl.dagger.io/dagger/install-pr-1819.sh \
    | DAGGER_VERSION=0.2.0 sh

One thing which I was not sure about is how the file from this
repository ends up on https://dl.dagger.io/dagger/install.sh. I think
this is a manual process today, but I need to confirm this assumption.

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-24 23:28:07 +00:00
Gerhard Lazu
c4104626c3
Merge pull request #1837 from marcosnils/feat/docs_os_select
Attempt to automatically select OS tab based on user user-agent
2022-03-24 23:10:32 +00:00
Jffarge
93d5a37508
Merge pull request #1835 from slumbering/gh-action-property
Fix the missing property "on" for getting started github action
2022-03-24 20:34:57 +01:00
Marcos Lilljedahl
70c49495aa Add BrowserOnly component to avoid SSG errors
Signed-off-by: Marcos Lilljedahl <marcosnils@gmail.com>
2022-03-24 16:02:27 -03:00
Solomon Hykes
c800cb5a3a
Merge pull request #1833 from marcosnils/fix/todoapp_cache
WIP: Add node_modules mount to improve caching times
2022-03-24 11:53:19 -07:00
Marcos Lilljedahl
52e7145874 Update windows benchmarks
Signed-off-by: Marcos Lilljedahl <marcosnils@gmail.com>
2022-03-24 12:52:17 -03:00
Andrea Luzzardi
fd2ccc0048 ci: disable telemetry
Signed-off-by: Andrea Luzzardi <aluzzardi@gmail.com>
2022-03-23 19:01:09 -07:00
Marcos Lilljedahl
b401cdafd9 Add markdownlint to Makefile
We're currently running markdownlint in CI and we didn't have a target
for that in our makefile. Adding that to prevent rejected PR's due to
markdown linting errors

Signed-off-by: Marcos Lilljedahl <marcosnils@gmail.com>
2022-03-23 15:35:49 -03:00
Marcos Lilljedahl
b47b51401f Attempt to automatically select OS tab based on user user-agent
This is a quick fix to attempt to automatically select the user's OS tab
on the pages that requires so which potentially avoids users following
incorrect docs

Signed-off-by: Marcos Lilljedahl <marcosnils@gmail.com>
2022-03-23 14:05:08 -03:00
jffarge
1ae43daa1a Fix the missing property "on" for getting started github action
Signed-off-by: jffarge <jf@dagger.io>
2022-03-23 15:50:22 +01:00
Marcos Lilljedahl
85b044ebf4 Update macOS benchmarks
Signed-off-by: Marcos Lilljedahl <marcosnils@gmail.com>
2022-03-22 17:24:48 -03:00
Marcos Lilljedahl
a1aa420bd5 Update docs with new linux benchmarks
Signed-off-by: Marcos Lilljedahl <marcosnils@gmail.com>
2022-03-22 16:47:01 -03:00
Tom Chauveau
6fe49a0294
Improve go use case example according to Gerhard's review
Signed-off-by: Vasek - Tom C <tom.chauveau@epitech.eu>
2022-03-17 17:28:38 +01:00
Solomon Hykes
4e6d5d487f
Merge pull request #1800 from gerhard/add-missing-entries-to-dagger-cue-api
Add missing definitions to Dagger CUE API docs page
2022-03-16 10:28:05 -07:00
Tom Chauveau
2d3acc61e0
Add dagger golang use case
Signed-off-by: Vasek - Tom C <tom.chauveau@epitech.eu>
2022-03-16 12:14:24 +01:00
Jeremy Adams
cde9d54589 Fix typo
Signed-off-by: Jeremy Adams <jeremy.adams.pdx@gmail.com>
2022-03-15 16:52:28 -07:00
Gerhard Lazu
dcf3b7ed21
Add missing definitions to Dagger CUE API
Link to the source of truth cue files.

While at it, move this page from Knowledge Base, which is a generic
category, to Core Concepts. The URL didn't change so that we don't break
existing links. FWIW /1213/dagger-cue would have been my choice.

Initially contributed as a change part of
https://github.com/dagger/dagger/pull/1758

Should be merged after https://github.com/dagger/dagger/pull/1799

Related to https://github.com/dagger/dagger/pull/1768

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-15 21:44:37 +00:00
Gerhard Lazu
ee95b323ab
Add What is Cue? page to Europa Docs sidebar
This duplicates the existing page and uses a new ID so that clicking on
it in one sidebar (pre-Europa) will not update the sidebar. We have
learned about this behaviour via
https://github.com/dagger/dagger/pull/1758

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-14 18:17:14 +00:00
Ben Gesoff
e0d2b5cd3b docs: fix typo in snippet
The reference to `docker.Copy` does not exist and should be `docker.#Copy` instead. This also leads to a confusing error message (possibly related to #493) as it isn't found while CUE is compiled, and instead results in the following runtime error:

```
[✗] actions.deps                                                                                                                                  2.1s
9:16PM FTL failed to execute plan: task failed: actions.deps._dag."2"._exec: invalid FS at path "actions.deps._dag.\"2\"._exec.input": FS is not set
```

Signed-off-by: Ben Gesoff <ben@gesoff.uk>
2022-03-13 21:38:03 +00:00
Gerhard Lazu
d48d484faf
Merge pull request #1705 from helderco/new-doc
Add front matter to new docs
2022-03-11 18:21:52 +00:00
Gerhard Lazu
881f2ee8ee
Merge pull request #1780 from helderco/doc-typo
[Doc] Fix doc typo
2022-03-11 18:20:51 +00:00
Helder Correia
45a1fb19d2
Fix doc typo
Added a few files to test the affected test.

Signed-off-by: Helder Correia <174525+helderco@users.noreply.github.com>
2022-03-11 16:56:22 -01:00
guillaume
fd473033af Complete Windows Getting-started doc
Doc tested and written with rc1 version, on Windows

Signed-off-by: guillaume <guillaume.derouville@gmail.com>
2022-03-11 18:16:30 +01:00
Jffarge
dcde3c929d
Merge pull request #1651 from senk/patch-1
Allow Fullscreen on Get Started Video
2022-03-11 14:25:31 +01:00
Andrea Luzzardi
9358945526 docs: migrate from 0.1
- Temporary page that just points to the GitHub Discussion
- Goal: create a stable link we can share, update with proper content
  later
- Wasn't sure how to categorize this so I've renamed `DRAFTS` into
  `Knowledge Base`

Signed-off-by: Andrea Luzzardi <aluzzardi@gmail.com>
2022-03-10 16:50:37 -08:00
Gerhard Lazu
da8e8fbaac
Extract snippets from docs into separate files
So that we get auto-formatting and syntax checking in our code editor.
The only snippets which have not been extracted are either terminal
output, or file fragments (e.g. CUE) which are not valid standalone files.

Resolves https://github.com/dagger/dagger/issues/1715

While at it, do a few fly-by improvements:
- beta.1 -> beta.2
- add CUE & BuildKit links
- up -> do

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-10 16:35:50 +00:00
Helder Correia
6204970d53
Move snippets outside of markdown
Signed-off-by: Helder Correia <174525+helderco@users.noreply.github.com>
2022-03-10 12:35:11 -01:00
Andrea Luzzardi
1d6f0acdd2
Merge pull request #1742 from gerhard/europa-docs-default
Default docs to Europa
2022-03-09 14:38:41 -08:00
Gerhard Lazu
4e869d1bcf
Merge pull request #1734 from gerhard/github-action-version-fix
Fix dagger-for-github version
2022-03-09 21:55:10 +00:00
Gerhard Lazu
74c3465ca0
Fix dagger-for-github version
We assume that this will be out by the time this goes live.

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-09 21:15:24 +00:00
Gerhard Lazu
9b22932cff
Default docs to Europa
There are a few outstanding tasks, but they can be finished tomorrow.
This is just the beginning of many refinements, so it's all good 🙌

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-09 20:12:50 +00:00
Gerhard Lazu
2b67e97cec
Europa docs plan updates after Client API & dagger do
Follow-up to https://github.com/dagger/dagger/pull/1683

Part of https://github.com/dagger/dagger/issues/1327

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-09 18:17:02 +00:00
Gerhard Lazu
b78be739aa
Merge pull request #1708 from helderco/build-images-doc
[Doc] Building container images
2022-03-09 17:28:50 +00:00
Helder Correia
a48d093fb8
Add documentation for building container images
Signed-off-by: Helder Correia <174525+helderco@users.noreply.github.com>
2022-03-09 16:10:17 -01:00
Gerhard Lazu
1974dd1df7
Update Europa docs - CI/CD in your local dev to the new netlify.cue
Follow-up to https://github.com/dagger/dagger/pull/1693

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-09 17:01:39 +00:00
Gerhard Lazu
c3f21958d2
Europa docs: From local dev to CI environment doc page
The todoapp example contains a Netlify plan which uses the latest dagger
additions: do & Client API. We are thinking of merging the examples
repository into this one to make working with this easier. This is a
step in that direction.

We are not using the yarn package so that we can revert
https://github.com/dagger/dagger/pull/1673 without breaking this
implementation.

The GitHub Action is WIP, we will continue with that tomorrow:
https://github.com/dagger/dagger-for-github/issues/24

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-08 22:17:24 +00:00
Helder Correia
83cd685cb3
Add front matter to new docs
Signed-off-by: Helder Correia <174525+helderco@users.noreply.github.com>
2022-03-08 11:32:10 -01:00
Helder Correia
da90baa087
Add new Client API
Signed-off-by: Helder Correia <174525+helderco@users.noreply.github.com>
2022-03-07 17:13:16 -01:00
Gerhard Lazu
9dece5ea77
Cover packages before caching
We are still figuring out caching, specifically Buildkit go client
caching, while packages is something that users can start creating right away.

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-06 00:07:17 +00:00
Gerhard Lazu
d693742477
Europa docs: get started with CI/CD in local dev
The idea is to start simple and get users a good feel for how this works
within 5 minutes or less. We should cover the three popular OSes, and
ensure that everything works as expected.

At the end of this, users will have Dagger set up for local CI/CD, and
know how to make a change to the example app and re-run the build, test
& deploy loop.

This is part of https://github.com/dagger/dagger/issues/1327

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-05 23:58:49 +00:00
Gerhard Lazu
1e0c5d5e7a
Temporarily remove Use Cases from the Europa docs sidebar
The current plan is to add them post 0.2.0 shipping, for now the focus
is on Getting Started & Core Concepts.

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-04 18:58:17 +00:00
Gerhard Lazu
6e3c35e1ad
Rename CI/CD platform to CI environment
As discussed here:
https://github.com/dagger/dagger.io/issues/38#issuecomment-1057469048

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-04 18:26:12 +00:00
Gerhard Lazu
bda88621b6
Add the dagger.#Plan core concept to Europa Docs
This is the entry point for all other core concepts.

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-04 13:47:32 +00:00
Gerhard Lazu
f2f2f7c38a
Add link to Europa docs
So that it's easy for anyone to jump to the new docs that we are
currently working on, and intend to replace the existing docs with.

While I would have preferred to link to the local dev page, it's still
stuck in the PR state, currently blocked on another PR:
https://github.com/dagger/dagger/pull/1586

Also added a link to the pre-Europa docs, so that it's easy to go back.

While at it, drop "Sidebar" from the name of sidebars, and replace
tutorial with a more descriptive name.

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-03 15:12:43 +00:00
Gerhard Lazu
df6b29e8cb
Capture the first CI/CD platforms that we intend to document
We invite users to help us prioritise via https://github.com/dagger/dagger/discussions/1677

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-03-03 14:03:26 +00:00
Almog Tavor
511584af62
Fix a typo in the docs
Fix a typo in the docs

Signed-off-by: Almog Tavor <almogtavor@gmail.com>
2022-02-23 23:43:28 +02:00
Joel Longtine
80a052afe0 Remove old docs
Signed-off-by: Joel Longtine <joel@dagger.io>
2022-02-23 12:20:01 -07:00
Joel Longtine
56ecf7f8cd Clean up .gitignore files
Signed-off-by: Joel Longtine <joel@dagger.io>
2022-02-23 12:20:01 -07:00
Joel Longtine
4cc93098a1 Remove old docs
Signed-off-by: Joel Longtine <joel@dagger.io>
2022-02-23 12:20:01 -07:00
Joel Longtine
eeb20a3999 Temporary fix for markdownlint
Signed-off-by: Joel Longtine <joel@dagger.io>
2022-02-23 12:20:01 -07:00
Joel Longtine
e8bd1acd85 make docs
Signed-off-by: Joel Longtine <joel@dagger.io>
2022-02-23 12:20:01 -07:00
Joel Longtine
0705b0eeae Skip non-europa tests
Signed-off-by: Joel Longtine <joel@dagger.io>
2022-02-23 12:20:01 -07:00
Joel Longtine
b32e2da0a5 make docs
Signed-off-by: Joel Longtine <joel@dagger.io>
2022-02-23 12:20:01 -07:00
Robin Naundorf
800f979ce6 Update 1003-get-started.md
Allow Fullscreen for Get Started Video

Signed-off-by: Robin Naundorf <r.naundorf@fh-muenster.de>
2022-02-23 10:58:19 +00:00
Gerhard Lazu
1d67845bcf
Answer a few contributor questions via a docs README
Related to:
- https://github.com/dagger/dagger/issues/1327
- https://github.com/dagger/dagger/issues/1510
- https://github.com/dagger/dagger/pull/1579/files#diff-cc0394489dc78fcfe672bb9883b760be86a495bf553b5bc950e6203779f00ae1
- https://github.com/dagger/dagger/pull/1632/files

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-02-18 15:58:23 +00:00
Solomon Hykes
724be92bb4 Utility script to create a new docs page with the correct ID
Signed-off-by: Solomon Hykes <solomon@dagger.io>
2022-02-17 01:41:59 +00:00
Solomon Hykes
c2766c265b Merge dagger.io/dagger/engine into dagger.io/dagger
Signed-off-by: Solomon Hykes <solomon@dagger.io>
2022-02-16 19:40:28 +00:00
Gerhard Lazu
d838cd6047
Fix markdown lint errors
Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-02-12 18:37:03 +00:00
Gerhard Lazu
3a2f861dd9
Finish the first version of the Go on Docker Swarm use case
Left a few TODOs and ideas for next steps. The goal is to get this live,
and enable others to iterate on it via separate PRs.

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-02-12 18:27:19 +00:00
Gerhard Lazu
3747c6e5c4
First pass at the Go on Docker Swarm doc page
There are a few more things to do before we can finish this, see the
comments in the doc. The most important item is to switch the Dagger
config to Europa. That is actually one of the next steps.

Sharing this early so that we start collaborating. Pushing to a branch
in the dagger org so that we can work on it together (personal
repositories make it more difficult).

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-02-11 15:35:24 +00:00
Gerhard Lazu
78d5d49f2c
Add the must-have pages for the Europa release
The goal is to capture the shape of the new docs. It is not meant to be
final, but it should be as close as possible. We only want the bare
minimum for new users that on-board with Dagger Europa. As soon as the
new europaSidebar replaces replaces the existing one, the previous docs
will still remain available - doc IDs are unique and permanent. We will
do this by simply changing the default `slug: /` to point to the Europa
Docs entrypoint, which is doc 1200.

Helpful Docusaurus link re multiple sidebars:
https://docusaurus.io/docs/sidebar/multiple-sidebars

The new pages are numbered from `1200` onwards. This is meant to reflect
the `0.2.0` Dagger version. This numbering felt more meaningful than
just continuing to increment existing numbers.

I didn't want to be "wasteful" with the digits and start at `2000`, but
that was my first instinct.

I am keen on getting this live on https://docs.dagger.io/1200/local-ci.
Anything that is not in production, is inventory. Inventory is bad.

The goal is to allow anyone that has a link to get a feel for the new
docs as soon as possible, so that we can all see how they improve in
real-time, and steer them continuously towards the desired state. We
should be aware of the timeline, and not muck about, but instead
evaluate constantly how close are we to "flipping the switch".

Remember, the best releases are those where switches are flipped (e.g.
`--europa)`. The feature will have been out there for weeks (maybe even
months), improved by talking to users and then one day realising that we
are done, and just enabling it by default. It's the same principle
behind these docs.

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-02-10 09:47:07 +00:00
Gerhard Lazu
c8e42af05a
Use unique IDs for all existing doc pages
- what_is didn't have an id, started with 1000 (it's easier to find this file now)
- operator-manual doc id was clashing with ci use-case

Signed-off-by: Gerhard Lazu <gerhard@lazu.co.uk>
2022-02-10 07:38:11 +00:00
Solomon Hykes
fab39bf3f7 Fix docs lint errors
Signed-off-by: Solomon Hykes <solomon@dagger.io>
2022-02-08 20:12:05 +00:00