Slashdot Mirror

← Back to Stories (view on slashdot.org)

Using the DocBook DTD for Internal Documents?

Posted by Cliff on from the going-digital dept.

Saqib Ali asks: "These days, most of the Linux Documentation is created using DocBook DTD. I was wondering if it will be useful for a large Enterprise to create Internal IT documents using DocBook DTD. Any success stories where a large enterprise converted all of its internal IT documentation to DocBook, with management's support? Any other things/issues to keep in mind before embarking on such a mission?"

1 of 58 comments (clear)

  1. We did it. by Some+guy+named+Chris · · Score: 5, Insightful

    It was a nightmare.

    Anyone who was not a programmer balked at the idea of having to write documentation in a (Gasp!) markup language. "Just give me Word!" they would whine.

    There is a lot of overhead associated with DocBook that most non-technical people don't want to deal with. They want a WYSIWYG editor, and will cry, kick, scream, and intentionally be completely unproductive until they get it.