Date: Thu, 26 Mar 1998 18:13:45 -0500 (EST) From: Tim Vanderhoek <ac199@hwcn.org> To: nik@iii.co.uk Cc: ac199@hwcn.org, Sean Kelly <kelly@plutotech.com>, doc@FreeBSD.ORG Subject: Re: [REVIEW] Changes to the DocProj web pages Message-ID: <Pine.BSF.3.96.980326171815.237A-100000@localhost> In-Reply-To: <19980326100250.00854@iii.co.uk>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, 26 Mar 1998 nik@iii.co.uk wrote:
> I've got no problems with changing it. Although I don't want to make it
> seem any less inviting. One of the things that's emerged from a couple of
> conversations that I've had is that apparently (and this was a surprise to
> me) the doc-proj is viewed in some quarters as some remote, forbidding club,
> for which you need the special handshake and funny walk to gain access.
I think this is partly because too many messages have gone
ignored on the -doc list and even more because the documentation
explaining the doc-proj talked about what the doc-proj does, what
the doc-proj is, etc., instead of saying this is what you can do,
this is how you are needed, etc.. I haven't actually read most
of the stuff explaining the doc-proj for a while, so I could be
wrong... :-) I think the stuff you just wrote is much much
better in this respect. It suggests a much more active and
involved doc-proj, instead of a removed institution.
> > 5) You sound a little optimistic about finding people willing to
> > mark-up submitted plain-text documents. Would you like me to
> > point you to an aging PR submitting just such a plain-text
> > document?
>
> Please. Preferably via the list, so someone else can grab it if they
> want to.
Okay, just glancing over the pr list, these are ones related the
docs system, in addition to just ones listing submitted
plain-text.
docs/2353 should be reviewed and possibly committed.
docs/3590 FAQ gives strange reccomendation re: ttys & xdm
docs/5070 plain-text FAQ submission
docs/4698 Change to handbook re: making repair floppies. I'm not
sure this is doc-proj stuff, but it's listed here. :)
docs/5545 Problem with rendered html from handbook
docs/6036 plain-text handbook submission
docs/5487 `Will someone please write some more information for
the handbook!'
docs/1691 LinuxDoc PPP documentation. PS. Use ":r" not
"!!cat ..." to read-in files when using vi. :)
docs/5247 Add reference to relevant Linux docs from FAQ
docs/5600 Some Nik Clayton joker thinks he has something to say :)
> > [On that topic, what do people think of assigning doc-related PRs
> > to the freebsd-doc list (similar to what's done for the
> > freebsd-ports list)? It seems that this is perhaps part of the
> > solution to our burgeoning PR list (eventually doing similar
> > things for freebsd-fs, etc.).]
>
> Good idea. Very good idea.
Okay, I'll rephrase this...
Are there any valid objections to assigning general doc-related
PRs to the freebsd-doc list?
[If not, I'll talk to Steve or someone and see if this requires
any special set-up in gnats]
--
tIM...HOEk
OPTIMIZATION: the process of using many one-letter variables names
hoping that the resultant code will run faster.
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.3.96.980326171815.237A-100000>