6 Paragraphs

6.1 Use paragraphs to structure the text (ASM-74)

  • Use a new paragraph for each new thought or statement.

  • Insert an empty line in between to create a new paragraph.

Exceptions

There are no exceptions.

Example

Code

This is a first thought in the first paragraph.
And this deepens the first thought.

This is a second thought in the following paragraph.

Result

This is a first thought in the first paragraph. And this deepens the first thought.

This is a second thought in the following paragraph.

Source

ASAM specific rule.

6.2 Just add one sentence per line (ASM-25)

  • Insert a line break after each sentence.

  • Do not add manual line breaks inside sentences.

  • Apply this rule on paragraphs and list items.

Instructions

  • "Only hit 'enter' after a period ('.'), but make sure to hit 'enter' after a period."

Exceptions

There are no exceptions.

Example

Code

This is the first sentence.
This is the second sentence.
This is the third sentence.

* This is the first sentence of the element.
This is the second sentence of the element.
* This is the second element.
* This is the third element.

Result

This is the first sentence. This is the second sentence. This is the third sentence.

  • This is the first sentence of the element. This is the second sentence of the element.

  • This is the second element.

  • This is the third element.

Source

ASAM specific rule.

6.3 Do not use manual line breaks (ASM-75)

Exceptions

  • Use manual line breaks in tables to insert a second paragraph into a table cell.

  • Use manual line breaks in lists to start explanations in a new line.

Example

Code

Code 2. Tables
|===
|First paragraph in a table cell. +
Second paragraph in a table cell.
|===
Code 3. Lists
* Useful for lists +
Detailed explanations begin in a new line after the main list element.

Result

First paragraph in a table cell.
Second paragraph in a table cell.

  • Useful for lists
    Detailed explanations begin in a new line after the main list element.

Source

ASAM specific rule.

6.4 Use of italic markup (ASM-71)

Use italic markup for terms that are contained in the Terms and definitions section.

The markup character is the underscore ( _ ).

Exceptions

There are no exceptions.

Example

Code

_term_

Result

term

Source

ASAM specific rule.