Use the following high-level guidelines when writing content in DITA. For more information about our DITA-XML authoring environment, see DITA and Tridion Docs Work Instructions and Guidelines.
Do not include elements such as lists and tables within the paragraph element for the preceding paragraph. Make sure that you insert any tables, unordered lists, or ordered lists after the closing <p> tag.
Follow the indexing guidelines in this document.
To avoid unnecessary complexity in your topics, use conditions sparingly. Only conditionalize complete sentences or blocks of text.
Use conrefs for complete sentences or other blocks of text that do not rely on the surrounding text for context.
Conref common inline uicontrol and wintitle elements, product names, and application names.
Set up DITA Maps for a group of topics as you work on the content, so that you can provide the associated DITA Map to localization with the content to be localized. With DITA Maps, translators get a sense of the content to be translated.
When you create container topics for reusable content in DITA, ensure that any information in the topic that is not product content is placed in an XML comment. If putting the text in an XML comment is not practical, set the translate attribute on that text to no. Otherwise, content that you do not want to translate is presented as translatable content.
