This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: Modular Documentation
- From: Norman Walsh <ndw at nwalsh dot com>
- To: Ed Manley <edmanley at bellsouth dot net>
- Cc: docbook at lists dot oasis-open dot org
- Date: Fri, 08 Feb 2002 14:05:13 -0500
- Subject: DOCBOOK: Re: Modular Documentation
- References: <NEBBLNHGMLKMPJODODFKAEOGCAAA.edmanley@bellsouth.net>
/ Ed Manley <edmanley@bellsouth.net> was heard to say:
| I ordered Norman Walsh's DocBook publication off of Amazon, but it won't be
| here for a few days, then I found this discussion list.
http://docbook.org/tdg/en for starters :-)
| How can a company, no, how can I in particular, being completely naive to
| XML, best get started learning and implementing modular documentation in a
| small company? I have looked at the DocBooks website, and considered trying
You face a number of challenges, some technical some non-technical. On
the whole, the non-technical challenges (teaching your authors to do
this "structured authoring" thing in a new tool) are much harder
(honest!).
As far as the technical challenges go, one of the things you need to
decide early on is what granularity if reuse you're interested in.
Trying to reuse chapters or sections in different manuals is a much
different problem than trying to reuse paragraphs.
Be seeing you,
norm
--
Norman Walsh <ndw@nwalsh.com> | People often say that this or that
http://www.oasis-open.org/docbook/ | person has not yet found himself.
Chair, DocBook Technical Committee | But the self is not something one
| finds, it is something one
| creates.--Thomas Szasz