Organising elements within re-use topics

You should use logical, identifiable id attributes. Short phrase-level elements intended for re-use can be organised into tables for ease of maintenance.

Easy-to-identify id attributes should be used for re-use elements. In choosing names, you should prefix the id values to indicate the purpose of the element, such as:
var_
for short re-use phrases and variables
term_
for terms and definitions
step_
for task steps
warning_
for warning notes
fig_
for figures

To provide a reference for how re-use elements are meant to be used, you may choose to organise re-use phrases (or variables) into tables, where a description of the element's intended use can be documented alongside the re-use content.


Screen capture of DITA editor showing conref variables organised into a table

Conref source file with re-use elements organised with a table
https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/Artefact/Content_Reuse/c_Organising_Variables.html
www.oxygenxml.com
crawl=CC-MAIN-2018-39
10882
application/http; msgtype=response
sha1:NRRF43QYEXDHJL2PKKGDALVIJWJHGP74
<urn:uuid:541efafd-2c54-4ff5-9537-5eff946e677c>
2018-09-25T19:27:21Z
52.38.177.216
text/html
sha1:OG37SVDOGLII57A7XIW2UOYT2HPMCIMM
<urn:uuid:f9ffa86b-769b-4450-b67b-f7106fc8a051>
https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/Artefact/Content_Reuse/c_Organising_Variables.html
response
<urn:uuid:de0ae7ac-87da-45f2-ad34-45bc2e520ca9>
isPartOf: CC-MAIN-2018-39
publisher: Common Crawl
description: Wide crawl of the web for September 2018
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-157-187-24.ec2.internal
software: Apache Nutch 1.15 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 0.11-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: http://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/