docs: Fix relative URLs, add a CONTRIBUTING.md note

Signed-off-by: Andrea Luzzardi <aluzzardi@gmail.com>
This commit is contained in:
Andrea Luzzardi 2021-07-22 13:34:53 +02:00
parent cff35ba2b5
commit 1df914acdc
3 changed files with 16 additions and 4 deletions

View File

@ -85,6 +85,18 @@ Guidelines:
- Format: Use the imperative mood in the subject line: "If applied, this commit - Format: Use the imperative mood in the subject line: "If applied, this commit
will _your subject line here_" will _your subject line here_"
## Docs
### Use relative links to markdown files
Link to markdown files (`[link](../foo.md)`) instead of relative URLs
(`[link](/foo)`).
The docs compiler will replace file links with relative URLs automatically.
This is to avoid broken links. If a file gets renamed, the compiler will
catch broken links and throw an error. Relative URLs get broken unnoticed.
## FAQ ## FAQ
### How to run the markdown linter locally ### How to run the markdown linter locally
@ -96,6 +108,6 @@ First install `markdownlint-cli`:
Then from the repository root: Then from the repository root:
``` ```console
markdownlint -c .markdownlint.yaml docs/**/*.md markdownlint -c .markdownlint.yaml docs/**/*.md
``` ```

View File

@ -121,4 +121,4 @@ dagger output list
## What's next? ## What's next?
At this point, you have deployed your first application using Dagger and learned some dagger commands. You are now ready to [learn more about how to program Dagger](/learn/102-dev). At this point, you have deployed your first application using Dagger and learned some dagger commands. You are now ready to [learn more about how to program Dagger](./1004-first-env.md).

View File

@ -18,7 +18,7 @@ The provisioning strategy detailed below follows S3 best practices. However, to
#### Relays #### Relays
The first thing to consider when developing a plan based on relays is to read their universe reference: it summarizes the expected inputs and their corresponding formats. [Here](/reference/universe/aws/cloudformation) is the Cloudformation one. The first thing to consider when developing a plan based on relays is to read their universe reference: it summarizes the expected inputs and their corresponding formats. [Here](../reference/universe/aws/cloudformation.md) is the Cloudformation one.
## Initialize a Dagger Workspace and Environment ## Initialize a Dagger Workspace and Environment
@ -132,7 +132,7 @@ template: """
##### 2. Cloudformation relay ##### 2. Cloudformation relay
As our plan relies on [Cloudformation's relay](/reference/universe/aws/cloudformation), let's dissect the expected inputs by gradually incorporating them into our plan. As our plan relies on [Cloudformation's relay](../reference/universe/aws/cloudformation.md), let's dissect the expected inputs by gradually incorporating them into our plan.
```shell ```shell
dagger doc alpha.dagger.io/aws/cloudformation dagger doc alpha.dagger.io/aws/cloudformation