When naming tasks, a technique I used and liked for a product I worked on was to name the heading “<noun>, <verb phrase>”.

My rationale is that users always know what object they are trying to work with, but they don’t always think with the same verbs in mind as the author. By putting the noun first, the tasks are automatically organized in the TOC by object and not by verb. The reader can then scan the TOC rather than having to read each task heading.

Read more

Hi,

I'm trying to publish DITA-map to PDF using DITAOT and RenderX - just a standard full installation, but my pdf-document inserted via <xref> doesn't appear in the final PDF - it wasn't copied into the OUT folder at all. Does anybody know is it possible to use cross-references to external pdfs just editing some settins; or xlst-s should be changed? Does DITAOT support external PDF-s in PDF-output?

Thanks,

Alex