docs: more docs guidelines

This commit is contained in:
Tasia Iso 2024-05-11 21:22:25 +02:00
parent 5551fd2dea
commit 0751699bc8
Signed by: tasiaiso
SSH Key Fingerprint: SHA256:KiRjUay5C9i6objsEOIycygBHn54pDBB3Lj7fyJ0Elw
2 changed files with 40 additions and 2 deletions

View File

@ -12,12 +12,20 @@ Alternatively, you can change the `origin` remote on your existing clone:
- I want to edit C code !
TODO
- I want to edit JavaScript code !
TODO
- I want to write documentation !
Great! Before you do, have a look at the [documentation guidelines](guidelines/documentation-guidelines.md) to learn how to write consistent documentation.
In all cases:
- Make sure that your commit messages are descriptive.
- Format your changes:
If you've edited C code: run `make format`

View File

@ -26,7 +26,37 @@ When writing documentation, the author should have in mind it's target audience:
### Style guide
TODO
1. Lines SHOULD NOT be wrapped, to allow clients to dynamically wrap them however they want:
```
This is not very pleasant to read because
the text
is manually wrapped, but the size of the
screen is
smaller than the size the text is wrapped
at. I
need to write even more useless text here
so I get
my point across. Also hi! If you're here
that
means you're either going to contribute to
Tilde
Friends, or that you're reviewing my
stupid
changes. Either way, you're awesome!
```
You MAY use one line per sentence.
2. Lines ending with an `inline code block` SHOULD NOT end with a period.
> Example: To build in docker, `docker build .`
NB: this does not apply to file names or other text that are not meant to be copy-pasted.
> Example: this document is named `docs/guidelines/documentation-guidelines.md` instead of `docs/guidelines/documentation.md` because it could cause confusion with `docs/documentation.md`.
More TODO
## License