85107272be
Based off conversation at the PTG, we agreed it would be beneficial to ensure the contrib-guide is clearly marked as the doc contrib guide outside of the title. This change includes a redirect. Change-Id: I5abf915f0b94a482afa961e6b86364c26aae5d79
56 lines
1.3 KiB
ReStructuredText
56 lines
1.3 KiB
ReStructuredText
.. _cg_titles:
|
|
|
|
======
|
|
Titles
|
|
======
|
|
|
|
Each RST source file has the tree structure. Define up to three heading
|
|
levels within one file using the following non-alphanumeric characters:
|
|
|
|
* **Heading 1** - underline and overline with equal signs;
|
|
|
|
* **Heading 2** - underline with tildes;
|
|
|
|
* **Heading 3** - underline with dashes.
|
|
|
|
**Input**
|
|
|
|
.. code::
|
|
|
|
=========
|
|
Heading 1
|
|
=========
|
|
|
|
Body of the first level section that includes general overview
|
|
of the subject to be covered by the whole section.
|
|
Can include several focused Heading-2-sections.
|
|
|
|
Heading 2
|
|
~~~~~~~~~
|
|
|
|
Body of the second level section that gives detailed explanation of one
|
|
of the aspects of the subject. Can include several Heading-3-sections.
|
|
|
|
Within user guides, it is mostly used to entitle a procedure with a set
|
|
of actions targeted at a single task performance.
|
|
For example, "Associate floating IP addresses".
|
|
|
|
Heading 3
|
|
---------
|
|
|
|
Body of the third level section.
|
|
It includes very specific content, and occurs mainly in guides containing
|
|
technical information for advanced users.
|
|
|
|
.. note::
|
|
|
|
Under- and overlines should be of the same length
|
|
as that of the heading text.
|
|
|
|
Avoid using lower heading levels by rewriting and reorganizing the
|
|
information.
|
|
|
|
.. seealso::
|
|
|
|
General :ref:`guidelines for headings and titles <headings>`
|