DocBook i praksis: Norwegian Unix User Group 10. april 2003 | ||
---|---|---|
Forrige |
[2] I have discovered the true purpose of DocBook and its ilk. The "look, I can run jade and have a new output format" is an impress-the-boss feature. Having a consistent look-and-feel is a bonus, but not enough of a win to put up with learning DocBook and finding decent tools in which to use it. No, the compelling reason to use DocBook and learn one's way around its document model is to force one's thoughts into a more orderly process *precisely to prevent poorly- organized documentation*! Yes, dear cow-orker, it *is* more difficult to use than vi. Yes, it *is* complex (although our needs will never encompass the majority of the model). However, it makes me much more likely to actually *think* about what I'm writing, how it's organized, and give it some sort of graceful structure rather then engage in the stream-of-consciousness stuff that ensures no one will be able to drudge their way through it even if they WANTED to!
-- Devin L. Ganger, "DocBook, CVS, and consulting", alt.sysadmin.recovery 17 Nov 2000