+--
| Hi, yesterday I talked with Camille on IRC about getting
| docbook used more in industry. I am searching for companies
| that already use it and that could give a good example about
| what they do with docbook and why they use it. And I also got
| one first contact I am going to write to.
+--
Not exactly industry, but all our college's computer center
publications are done in DocBook 4.3 (yes, yes, I know, I'll move
to 5.0 if I ever finish migrating all our old HTML to our new
Pylons site).
http://www.nmt.edu/tcc/help/pubs/index/
I currently maintain several hundred DocBook documents. DocBook
is also my preferred framework for literate programming:
http://www.nmt.edu/~shipman/soft/litprog/
When I start a new coding project, the first thing I do is set up
the directory for DocBook and write up the requirements. Next, I
flesh out the specification. Next step is to write up the design
and include diagrams and tables for such design artifacts as
entity-relationship diagrams and schema pictures. Then the code
goes right in the same document so it is single-sourced there.
Here's our peer-reviewed journal article on this subject:
Stavely, Allan, Lynda Walsh, and John Shipman.
Lightweight literate programming: a documentation
practice. Technical Communication 55(1), Feb. 2008.
I love DocBook and wish to thank all the many people who built it
and continue to maintain and enhance it. A marvelous tool and
the pivot around which all my documentation and software design
practice rotate.
Best regards,
John Shipman (j...@nmt.edu), Applications Specialist, NM Tech Computer Center,
Speare 119, Socorro, NM 87801, (575) 835-5735, http://www.nmt.edu/~john
``Let's go outside and commiserate with nature.'' --Dave Farber
---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
