Transitions
Instead of subheadings, separators between paragraphs and text body elements can be used to mark text divisions or to indicate changes in subject or emphasis. The separation of paragraphs and text body elements using separators is called a transition.
Properties
- A transition should neither start nor end a comment or section. In addition, two transitions should not be directly below each other.
- The syntax for a transition marker is a horizontal line with four or more characters. Valid separators are all non-alphanumeric 7-bit ASCII characters (e.g. "-", "+", "*", "="). A blank line must be inserted before and after the transition marker.
- Unlike the section titles, no hierarchy of transition markers is created. Differences in the transition markers have no effect. It is recommended to use a uniform style.
Sample
(In sample project: B_DocuElements\Comment structure\FB_Libdoc_Transitions)
(*
A transition marker is a horizontal line
of 4 or more repeated punctuation characters.
------------
A transition should not begin or end a section or document,
nor should two transitions be immediately adjacent.
*)