codewriting
codewriting copied to clipboard
Docs as Code section - define 'document level'
- Content is managed as discrete components of a whole, instead of merely at the document level
Is it necessary to define what is meant by "document level"? Will documentarians who aren't familiar with topic-based authoring techniques know what "document level" means or "discrete components"? Will it surprise anyone that a document could be one page or hundreds or thousands of pages? But "document" in this sense infers a dead tree format, which doesn't make as much sense when looking at a web page that is only connected to another web page through a hyperlink. Conceptually, they may or may not belong together, but one can be updated without affecting the other. So, where does the "document" begin and where does it end?
For a much longer discussion, see Mark Baker's Every Page is Page One.