[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: "Section" in *.doc-base file.

On Wed, Aug 22, 2001 at 12:34:39PM -0400, Adam Di Carlo wrote:
> FYI, I have made your summary into a bug against doc-base, which I'm
> CC'ing here.  If people can be sure to CC the bug this in the
> discussion, I'll get a copy of the discussion.

Yoshito's summary is admirably concise.

However, I would like to reemphasize that documentation covers more
than runnable programs.  It is artificial and confusing to separate
documentation about a programming tool from documentation about a
programming library, simply because the first is a program and the
second is not.  Both are related to "programming" and the
documentation navigation should reflect that.

(Fuller argument in 

> I have some ideas about a more flexible subject structure.  We really
> need something like a "subject authority list" -- massively simpler
> say than the Library of Congress one, but I don't see why we can't
> lift some ideas from there.

This sounds promising, but I hope you are serious about the "massively
simpler" bit.  :-) I wouldn't like to see more than a dozen or so
choices at each level of the menu.

> Anyhow, I do already have a provision doc-base structure, 

I'd like to have a look.  How can I get ahold of this?


by Rocket to the Moon,
by Airplane to the Rocket,
by Taxi to the Airport,
by Frontdoor to the Taxi,
by throwing back the blanket and laying down the legs ...
- They Might Be Giants

Reply to: