MIRRORS/poky
1
0
Fork 0
mirror of git://git.yoctoproject.org/poky.git synced 2025-07-19 12:59:02 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity

standards.md: add a section on admonitions

Browse Source 
We try to limit our usage of these admonitions to `note` and `warning`,
as the Sphinx documentation warns that most themes only style these two
admonitions. So add a section on that.

Suggested-by: Quentin Schulz <quentin.schulz@cherry.de>
Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
(From yocto-docs rev: 0c1252b67e602ebf7197e1388dd1fb86b37d25c8)

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Antonin Godard 2024-11-18 15:24:01 +01:00 committed by Richard Purdie
parent a5c9bff2b7
commit 129756e664
1 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
documentation/standards.md
View File

@ -109,6 +109,21 @@ or in the BitBake User Manual
If it is not described yet, the variable should be added to the
glossary before or in the same patch it is used, so that `:term:` can be used.
### Admonitions
Sphinx has predefined admonitions that can be used to highlight a bit of text or
add a side-note to the documentation. For example:
```rst
.. note::
This is a note admonition.
```
We try to limit our usage of these admonitions to `note` and `warning`, as the
Sphinx documentation [warns](https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#directives)
that most themes only style these two admonitions.
## ReStructured Text Syntax standards
This section has not been filled yet