fantasai <[EMAIL PROTECTED]> wrote in message news:<[EMAIL PROTECTED]>... > Peter Wilson wrote: > > DocBook does have this capability but is way too complicated. Soooo hard to define need precisely in advance!
> > The answer is to select a subset of useful tags from DocBook which > > are sufficient to the task. I'm not sure this is a trivial task. > > I'm betting that 50 tags would do the job. +/- how many? Which 50? What if one you left out is key? *I've seen "simple" problems go exponential ... not pretty.* > > This has the advantage that the tag documentation already exists. A Help > > Writers guide would be all that would be required. *Gawd, don't you love the optimistic impunity of a young champion? (no sarcasm)* > I agree. *yikes* > There's actually already a simplified form of DocBook released by > the DocBook Technical Committee: http://www.docbook.org/xml/simple/ Hey, that's true! How about selecting one slab of the "application suite" and document it with DBSimp, as proof of concept. Worst case, one slab is well documented in a format that allows the work to be salvaged. hfx_ben *new to tech_doc? buy kevlar underpants tomorrow!*
