mirror of
git://git.yoctoproject.org/poky.git
synced 2025-07-19 21:09:03 +02:00
doc: standard for bulleted lists
(From yocto-docs rev: 78bfe970529efeb93493407cedeb03056ade2bd2) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
eb633e611d
commit
8a5caba863
|
@ -7,6 +7,31 @@ It is currently a work in progress.
|
||||||
|
|
||||||
## Text standards
|
## Text standards
|
||||||
|
|
||||||
|
### Bulleted lists
|
||||||
|
|
||||||
|
Though Sphinx supports both the ``*`` and ``-`` characters
|
||||||
|
for introducing bulleted lists, we have chosen to use
|
||||||
|
only ``-`` for this purpose.
|
||||||
|
|
||||||
|
Though not strictly required by Sphinx, we have also chosen
|
||||||
|
to use two space characters after ``-`` to introduce each
|
||||||
|
list item:
|
||||||
|
|
||||||
|
- Paragraph 1
|
||||||
|
|
||||||
|
- Paragraph 2
|
||||||
|
|
||||||
|
As shown in the above example, there should also be an empty
|
||||||
|
line between each list item.
|
||||||
|
|
||||||
|
An exception to this rule is when the list items are just made
|
||||||
|
of a few words, instead of entire paragraphs:
|
||||||
|
|
||||||
|
- Item 1
|
||||||
|
- Item 2
|
||||||
|
|
||||||
|
This is again a matter of style, not syntax.
|
||||||
|
|
||||||
### Line wrapping
|
### Line wrapping
|
||||||
|
|
||||||
Source code for the documentation shouldn't have lines
|
Source code for the documentation shouldn't have lines
|
||||||
|
|
Loading…
Reference in New Issue
Block a user