From 79435c3b3c030f57fa0741c6deb67ffaa3819a44 Mon Sep 17 00:00:00 2001 From: erkin Date: Sat, 23 Jan 2021 15:11:15 +0300 Subject: docs: Refer to the larger set of documentation guidelines --- docs/contributing/documentation.rst | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) (limited to 'docs/contributing') 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 ^^^^^^^^ -- cgit v1.2.3