Link to doc style doc

(and update it to cover extra section characters)
pull/977/head
Richard van der Hoff 8 years ago
parent 56547ad373
commit b5d68b8ff1

@ -87,6 +87,9 @@ matrix-doc should be based on the ``master`` branch.)
Code style Code style
~~~~~~~~~~ ~~~~~~~~~~
The documentation style is described at
https://github.com/matrix-org/matrix-doc/blob/master/meta/documentation_style.rst.
Python code within the ``matrix-doc`` project should follow the same style as Python code within the ``matrix-doc`` project should follow the same style as
synapse, which is documented at synapse, which is documented at
https://github.com/matrix-org/synapse/tree/master/docs/code_style.rst. https://github.com/matrix-org/synapse/tree/master/docs/code_style.rst.

@ -19,11 +19,17 @@ RST support lots of different punctuation characters for underlines on sections.
Content in the specification MUST use the same characters in order for the Content in the specification MUST use the same characters in order for the
complete specification to be merged correctly. These characters are: complete specification to be merged correctly. These characters are:
- ``=`` : Top-level sections - ``=``
- ``-`` : Second-level sections - ``-``
- ``~`` : Third-level sections - ``~``
- ``+`` : Fourth-level sections - ``+``
- You should rethink your document layout if you require a fifth level. - ``^``
- `````
- ``@``
- ``:``
If you find yourself using ``^`` or beyond, you should rethink your document
layout if possible.
TODOs TODOs
----- -----

Loading…
Cancel
Save