diff options
author | erkin <e.altunbas@vyos.io> | 2021-01-23 15:11:15 +0300 |
---|---|---|
committer | erkin <e.altunbas@vyos.io> | 2021-01-23 15:11:15 +0300 |
commit | 79435c3b3c030f57fa0741c6deb67ffaa3819a44 (patch) | |
tree | 042d3cc2c5d96e5394b334c3c0fffa1e241d7f77 /docs/contributing/documentation.rst | |
parent | 981cf62960fdc0471b0226bf6fe113d9cc9986ed (diff) | |
download | vyos-documentation-79435c3b3c030f57fa0741c6deb67ffaa3819a44.tar.gz vyos-documentation-79435c3b3c030f57fa0741c6deb67ffaa3819a44.zip |
docs: Refer to the larger set of documentation guidelines
Diffstat (limited to 'docs/contributing/documentation.rst')
-rw-r--r-- | docs/contributing/documentation.rst | 16 |
1 files changed, 11 insertions, 5 deletions
diff --git a/docs/contributing/documentation.rst b/docs/contributing/documentation.rst index 71495f4e..dd6680a9 100644 --- a/docs/contributing/documentation.rst +++ b/docs/contributing/documentation.rst @@ -10,12 +10,13 @@ use through LaTeX. Guidelines ^^^^^^^^^^ -There are a few small things to keep in mind when contributing to the -documentation, for the sake of consistency and readability. When in doubt, -follow the style of existing documentation. +There are a few things to keep in mind when contributing to the +documentation, for the sake of consistency and readability. -Remember that the reStructuredText files aren't exclusively for generating -HTML and PDF. They should be human-readable and easily perused from a console. +Take a look at the `Documentation`_ page for an intricate explanation +of the documentation process. + +The following is a quick summary of the rules: - Use American English at all times. A spell checker can be helpful for this. - Don't forget to update `index.rst` when adding a new node. @@ -24,6 +25,11 @@ HTML and PDF. They should be human-readable and easily perused from a console. - Use literal blocks for longer snippets. - Leave a newline before and after a header. - Indent with two spaces. +- When in doubt, follow the style of existing documentation. + +And finally, remember that the reStructuredText files aren't +exclusively for generating HTML and PDF. They should be human-readable +and easily perused from a console. Building ^^^^^^^^ |