codewriting icon indicating copy to clipboard operation
codewriting copied to clipboard

Docs as Code section - define 'document level'

Open lief-erickson opened this issue 6 years ago • 0 comments

  1. 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.

lief-erickson avatar Jul 28 '18 17:07 lief-erickson