Paragraphs in reference topics

Paragraph (p) elements should not be used in reference topics, as reference topics are intended to contain facts, not ideas.

Reference topics are designed to contain look-up information, typically organised in a tabular form. As such, paragraph elements containing more narrative ideas than look-up data will normally have no place in a reference topic.

The DITA standard does not permit p elements in the body of a reference topic unless contained within elements such as refsyn and section.

Do not use workarounds (such as embedding p elements in sections without titles) in order to include a paragraph. Avoid inserting multiple paragraphs in syntax descriptions (refsyn elements), as these elements are intended to be brief descriptions.

As with other information types, you should avoid using section elements wherever possible.