Between the Devil and the DTD:
authoring in the Brave New World of
structured documentation
In the Brave New World of structured documentation, writers find themselves between a rock and a hard place, between the Devil (following provided templates and guidelines, but always teetering precariously near the abyss of chaos) and the DTD (requiring unswerving allegiance to an inflexible set of rules).
Before structured documentation |
After structured documentation |
Lone writers in their garrets |
Collaborative authors in a CMS |
Writer as artist |
Author as specialist |
The tyranny of the template |
The dictatorship of the DTD |
Personal WYSIWYG tools |
Integrated collaborative toolkits |
|
The Devil made me do it |
The DTD made me do it |
Design: |
Template and style overrides |
Rearrange content to fit the rules |
Organization: |
Traditional top-down outline |
Modular bottom-up mindmap |
Output: |
Tweak layout at the last minute |
Settle for imperfect layout and display |