Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 25 Jun 1997 13:28:51 -0500 (EST)
From:      John Fieber <jfieber@indiana.edu>
To:        Francisco Reyes <francisco@natserv.com>
Cc:        "Jordan K. Hubbard" <jkh@time.cdrom.com>, FreeBSD Chat <chat@FreeBSD.ORG>, doc@FreeBSD.ORG
Subject:   Re: FreeBSD documentation (was: OS/2 users going to FreeBSD?)
Message-ID:  <Pine.BSF.3.96.970625124950.12349A-100000@fallout.campusview.indiana.edu>
In-Reply-To: <199706251633.MAA24988@federation.addy.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, 25 Jun 1997, Francisco Reyes wrote:

> Now that I have a bit more knowledge I lack the time, and still don't
> know how to contribute to the doc project. In particular it should be
> easy to find the location of the existing documents, how changes
> should be submited (including an example on using diff) and to who
> they should be submited. A template SGML file would also be very
> helpful (if SGML is still been used)

I'll see what I can do to documenting and streamline the
submission policy.  The best info at the moment is
http://www.freebsd.org/docproj.html, but it isn't very prominent
and could use a lot more "how to" information. 

It may be better to de-emphasize issues of document format. If
the *content* is good, I really don't care what the format
is--SGML tagging is fairly mindless work. Unfortunatly, good
programming skill and good technical writing skill seem to be
mutually exclusive in practice.  The FreeBSD crowd tends to have
a lot more programmers than writers. 

-john




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.3.96.970625124950.12349A-100000>