Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 25 Jun 97 12:31:26 
From:      "Francisco Reyes" <francisco@natserv.com>
To:        "Jordan K. Hubbard" <jkh@time.cdrom.com>
Cc:        "FreeBSD Chat" <chat@FreeBSD.ORG>
Subject:   FreeBSD documentation (was: OS/2 users going to FreeBSD?)
Message-ID:  <199706251633.MAA24988@federation.addy.com>

next in thread | raw e-mail | index | archive | help
On Wed, 25 Jun 1997 08:04:35 -0700, Jordan K. Hubbard wrote:

>I think it's the paid part which does it.  Happily, I'm now
>interviewing for a paid writer's position now so that this component
>of the problem can be dealt with.

I am so happy to hear someone will be dedicated to this (I hope the
results are as good as the changes to the web site).

May I suggest that the first thing this person revises/writes are the
sections on how to contribute to the doc project. I once had the time
and interest on helping on documentation, but simply could not figure
out how to do it. I think it could be broken down on:

-How to help with the handbook.
-How to help with the man pages.
-How to submit tutorials.

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)

By spending some of the initial efforts on this, would have a great
long term benefits for the documentation since it will make it easier
for people to help.




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