Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs as Code section - define 'document level' #17

Open
lief-erickson opened this issue Jul 28, 2018 · 0 comments
Open

Docs as Code section - define 'document level' #17

lief-erickson opened this issue Jul 28, 2018 · 0 comments

Comments

@lief-erickson
Copy link

  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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant