openstack-manuals/doc/doc-contrib-guide/source/rst-conv/titles.rst

1.3 KiB

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

=========
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.

General guidelines for headings and titles <headings>