Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 26 Mar 1998 04:53:37 +1100
From:      Sue Blake <sue@welearn.com.au>
To:        freebsd-newbies@FreeBSD.ORG
Subject:   [REVIEW] Changes to the DocProj web pages
Message-ID:  <19980326045337.59707@welearn.com.au>

next in thread | raw e-mail | index | archive | help
Everyone interested in documentation should take a close look here!

This announcement was posted to freebsd-doc and is a good example of how
completed work is checked. Read on to find out about the whole process.

Note that all review comments and discussions are held in public on the
one relevant mailing list (in this case, freebsd-doc for documentation).

Nik isn't subscribed to -newbies yet. To make sure that he (and everyone
on freebsd-doc) sees your comments, please cc: them to
freebsd-doc@freebsd.org.

If you want to watch the documentation process as it happens, and
certainly if are writing or reviewing documentation yourself, you should
subscribe to -doc. Note that it is a fairly low volume high quality
mailing list so don't take any of my bad habits with you :-)


-----Forwarded message from nik@iii.co.uk-----

Date: Wed, 25 Mar 1998 11:00:53 +0000
To: doc@FreeBSD.ORG
Cc: jfieber@FreeBSD.ORG, mbarkah@FreeBSD.ORG, paul@FreeBSD.ORG,
        dave@FreeBSD.ORG
Subject: [REVIEW] Changes to the DocProj web pages

Hi folks,

[ sent to -doc, and a few individuals who should definitely see this 
  before it's committed ]

Based on comments made on this list and to me in private over the past
week or so, I've made a stab at rewriting and expanding some of the
information about the project that's available on the web site. The aim
is to make the public face for the DocProj appear more open and 
approachable.

If you go to 

    <URL:http://www.freebsd.org/~nik/dp/docproj.html>;

you'll see my proposed replacement for

    <URL:http://www.freebsd.org/docproj.html>;

I put this together in about an hour and a half last night, so I've
undoubtedly missed stuff, or phrased things confusingly.

I know that I've repeated some of the information that's available in 
other places, particularly the Handbook. However, many of the comments
I've read have been about how the necessary information isn't all in
one place. I know the proper solution is to get all this stuff into the
Handbook, but I don't see a long queue of volunteers submitting diffs,
so this is, at least, a start.

I'd appreciate folks taking a look at this, letting me know what they think.
If the overall reaction is positive I'll commit it next week (which should
give enough time for any discussion it generates).

Feel free to repost this to other lists, if you think it's appropriate.

N
-- 
Work: nik@iii.co.uk                       | FreeBSD + Perl + Apache
Rest: nik@nothing-going-on.demon.co.uk    | Remind me again why we need
Play: nik@freebsd.org                     | Microsoft?

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message

-----End of forwarded message-----

-- 

Regards,
        -*Sue*-

find / -name "*.conf" |more


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-newbies" in the body of the message



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19980326045337.59707>