Re: Need idea for upper level section name
On Mon, Apr 27, 1998 at 03:07:47AM -0400, Adam P. Harris wrote:
> Marcus Brinkmann <Marcus.Brinkmann@ruhr-uni-bochum.de> writes:
> > Could some people please suggest names for a section that covers the
> > following subsections (not necessarily in that order, priority or
> > whatever).
>
> > LDP/
> > Books/
> > HOWTO/ # a copy of the howto's registration for fast access
> > FAQ/ # same here. I assume they are actually part of LDP, aren't they?
> > Books/
> > LDP@ -> LDP/Books/
> > XBooks/
> > License/
> [...]
> > Standards/
> > RFC/
> > W3C/ # if ever will be packaged
>
> It is, isn't it?
Yes, I was confused by dfsg-freeness of standards et al. Mistake on my side.
> How about IANA port assignments, would that go in here?
If I would know what it is, I could probably tell you ;) There are a lot of
documents I'm not aware of right now, which is one reason why I want to
create more examples for my own, just to be sure I don't miss anything
important. However, there will be no delay because of this, as I will only
do it roughly and not complete.
> Looks like the section should be called "Reference Materials" or
> "Computer Reference Material"?
Reference Material is maybe the closest 'til yet.
> I guess you're looking at larger
> reference and documentation that is not Debian-specific?
Most documentation is not Debian specific. I'm not sure about this right
now. The following needs to be adressed:
1) Marco expressed his desire to have a HOWTO/ section for all howtos (and
he agrees that all howtos should be also referenced in the main sections
somewhere).
2) We have books that have a scope that is far broader than even one of the
top level sections. So we need a place for them, too.
3) The third thing is that we need a place for standards.
> Would
> documents on SGML (i.e., an SGML tutorial, etc) go in here?
No, as a SGML tutorial has a well defined goal and scope. It would go in
some sgml section (but please don't ask me where right now, it is all in
flux at the moment, as I'm to the transition to my second draft).
Thank you,
Marcus
--
"Rhubarb is no Egyptian god." Debian GNU/Linux finger brinkmd@
Marcus Brinkmann http://www.debian.org master.debian.org
Marcus.Brinkmann@ruhr-uni-bochum.de for public PGP Key
http://homepage.ruhr-uni-bochum.de/Marcus.Brinkmann/ PGP Key ID 36E7CD09
--
To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: