This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: Re: A straw proposal for help topics in DocBook
- To: docbook at lists dot oasis-open dot org, ndw at nwalsh dot com
- Subject: Re: DOCBOOK: Re: A straw proposal for help topics in DocBook
- From: Bob Stayton <bobs at caldera dot com>
- Date: Thu, 18 Oct 2001 11:04:22 -0700 (PDT)
- List-Id: <docbook.lists.oasis-open.org>
> From: Norman Walsh <ndw@nwalsh.com>
>
> / Karl Eichwalder <keichwa@gmx.net> was heard to say:
> | Thanks for the proposal. IMO, it superfluous; "topics" are just
> | sections. People should write a specialized stylesheet to process
> | "help" sections.
>
> I think there's a little more to it than that. And there is definitely
> a lot more to it than that psychologically.
>
> | Please, stay away from making DocBook more complex than absolutely
> | necessary.
>
> I hear you.
I think Karl's point is that before new elements are added
to Docbook, that someone should convince the skeptics that the
legitimate needs for generating help output cannot be met
using existing elements, role attributes, and stylesheets.
It seems we are implementing new elements before we are clear
on the requirements. If someone were to write a list of
requirements for help content, then someone else might go
off and design a customization that meets those
needs without adding new elements. If that proves to be
impossible, or produces an extremely awkward implementation,
then new elements should be considered.
Norm's original mail gave three reasons why help elements
are needed, but those reasons aren't enough for designing
a system. I think there are a bunch of processing
expectations around different help systems that would
influence the design. Is it too much to ask that someone
write up a list of requirements for help content?
I think if we could agree to some requirements then the
system design would be much easier. 8^)
bobs
Bob Stayton 400 Encinal Street
Publications Architect Santa Cruz, CA 95060
Technical Publications voice: (831) 427-7796
Caldera International, Inc. fax: (831) 429-1887
email: bobs@caldera.com
----------------------------------------------------------------
To subscribe or unsubscribe from this elist use the subscription
manager: <http://lists.oasis-open.org/ob/adm.pl>