• As it makes sense, use the .. code-block:: [language] form to insert literal blocks into the text. While the double colon, :: , is functional, the .. code-block:: [language] form makes the source easier to read and understand. 

• For all mentions of referenced types (i.e. commands, operators, expressions, functions, statuses, etc.) use the reference types to ensure uniform formatting and cross-referencing. 

