mirror of
https://github.com/element-hq/synapse
synced 2024-09-01 20:20:20 +00:00
44 lines
1.2 KiB
ReStructuredText
44 lines
1.2 KiB
ReStructuredText
|
===================
|
||
|
Documentation Style
|
||
|
===================
|
||
|
|
||
|
A brief single sentence to describe what this file contains; in this case a
|
||
|
description of the style to write documentation in.
|
||
|
|
||
|
|
||
|
Sections
|
||
|
========
|
||
|
|
||
|
Each section should be separated from the others by two blank lines. Headings
|
||
|
should be underlined using a row of equals signs (===). Paragraphs should be
|
||
|
separated by a single blank line, and wrap to no further than 80 columns.
|
||
|
|
||
|
[[TODO(username): if you want to leave some unanswered questions, notes for
|
||
|
further consideration, or other kinds of comment, use a TODO section. Make sure
|
||
|
to notate it with your name so we know who to ask about it!]]
|
||
|
|
||
|
Subsections
|
||
|
-----------
|
||
|
|
||
|
If required, subsections can use a row of dashes to underline their header. A
|
||
|
single blank line between subsections of a single section.
|
||
|
|
||
|
|
||
|
Bullet Lists
|
||
|
============
|
||
|
|
||
|
* Bullet lists can use asterisks with a single space either side.
|
||
|
|
||
|
* Another blank line between list elements.
|
||
|
|
||
|
|
||
|
Definition Lists
|
||
|
================
|
||
|
|
||
|
Terms:
|
||
|
Start in the first column, ending with a colon
|
||
|
|
||
|
Definitions:
|
||
|
Take a two space indent, following immediately from the term without a blank
|
||
|
line before it, but having a blank line afterwards.
|