Re: DOCBOOK: online help

["M. Wroth" <mark@astrid.upland.ca.us>]

That would be really helpful.  What I've been doing (to the extent I have a 
working solution, which is not very) has been to process the documentation 
as a book, render it into HTML, and then compile it with HTMLHelp 
(manually).  It sort of works :-) but I wouldn't hold the result up as a 
great example of on-line help.

At 12:56 PM 3/15/01 -0500, Nancy (Paisner) Harrison wrote:
>Hi,
>
>In response to Norm's invitation on the xml-doc list, I'd like to bring up
>the subject of using, extending, or modifying DocBook for online help use.
>
>We're currently implementing a customized version of DocBook for our print
>documentation at the CMBU (ClearCase business unit) within Rational.
>
>We will also be movng our online help documentation to XML within the next
>year, and we'd like to use many of the basic DocBook structures. We have a
>lot of data in our online help that is replicated in our books, and we
>really need to reuse that material for cleaner maintenance.
>
>But the DocBook hierarchy simply doesn't accomodate online help as well as
>we need it to.  We're currently considering writing a second hierarchy
>module to cover the helpset hierarchy; we haven't completely investigated
>the possible implications of this, but will need to before we really get
>into the work.
>
>What are other people doing to use the DocBook information pool for their
>online help, without trying to force it into the book model?
>
>BTW, if someone could subscribe me to this list, or tell me how to do it
>('subscribe' in the body of the mail, or the subject line?), I'd appreciate
>it. Otherwise, I won't see any replies.
>
>Thanks,
>
>Nancy
>
>
>
>________________________
>Nancy (Paisner) Harrison
>Rational Software
>Lexington  MA
>
>------------------------------------------------------------------
>To unsubscribe from this elist send a message with the single word
>"unsubscribe" in the body to: docbook-request@lists.oasis-open.org

Mark B. Wroth
<mark@astrid.upland.ca.us>