Why is the result often a million little pieces even though DITA does not encourage authors to chunk information in such a way?
In pursuit of the ultimate techCom information architecture
A lot of discussions and confusion in social media has recently, as it seems, dealt with two issues concerning the use of DITA (see for example a discussion in the DITA awareness group on linkedIn or another discussion on LinkedIn or a blog post by Tom Johnson). The first issue relates to the question if topics shall be nested or not, that is, shall DITA topics be kept as separate files or shall authors instead use a <dita> document and nest topics within it? The discussion regarding this first issue is about advantages and drawbacks and when to not do one or the other. Some say "nest, yes!" and some say "leave it, period!".
The second issue relates to the size of a topic regarding how big or small it shall be, which leads us to a more profound question: What is a (DITA) topic? It seems that many users adopting a topic based authoring approach are confused about how to address these two issues. Many users of DITA end up managing millions of small fragments, called topics. And they ask themselves, since each topic has an overhead cost associated with it: Do we really need to chunk our content into millions of pieces since that leads to "millions of cost" and upset user since they are getting unusable small fragments in their on-line help? Others are worried that they chunk content in too big files which overloads the user and hinders reuse. This blog post discusses various perspectives on this issue and tries to sort things out. Read more.
- Jonatan Lundin's blog
- Login to post comments
- 3791 reads
A quibble when there's so
A quibble when there's so much interesting content in this post, but if "every page is page 1" then we need to take even more care to spell out acronyms on first appearance <vbg>
European and Mediterranean Plant Protection Organization (EPPO) sounds eminently worthwhile, but doesn't have much to do with chunking structured documentation.
Thanks for the comment. The
Thanks for the comment. The EPPO acronym is now spelled out as Every Page is Page One.