Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 16 Apr 1996 09:42:17 -0600
From:      Sean Kelly <kelly@fsl.noaa.gov>
To:        J.P.Jansen@net.hcc.nl
Cc:        doc@freebsd.org
Subject:   Re: documentation project
Message-ID:  <9604161541.AA09509@fslg8.fsl.noaa.gov>
In-Reply-To: <9604151857.AA03342@solair1.inter.NL.net> (J.P.Jansen@net.hcc.nl)

next in thread | previous in thread | raw e-mail | index | archive | help
>>>>> "Jos" == J P Jansen <J.P.Jansen@net.hcc.nl> writes:

    Jos> Tell me more about taking part in the FreeBSD documentation
    Jos> project. I may have a few items to contribute.

The more, the better.  Thanks for being willing to contribute!

    Jos> Immediately available are some hints on PPP configuration
    Jos> (the result of some work I did on my own home page) and on
    Jos> the configuration of E-mail systems for users of dial-up IP
    Jos> accounts.

We already do have some documentation on PPP configuration, but it
wouldn't hurt to have some supplementary material---particularly if
you could provide more examples with dynamic and static IP assignment,
PAP authentication, etc.

As for email config for dial-up IP users, I don't think there's any
material yet in the handbook.  It'd be nice to have some!

    Jos> I have also written in English and in Dutch about the
    Jos> installation and maintenance of uucp. I'd be willing to
    Jos> assist in preparing a chapter on PC Cards.

UUCP!  Yes!  We need that!

    Jos> I suppose that you have guidelines for writing documentation;
    Jos> I'd appreciate a copy if you think I can help.

We don't have a style sheet or wordlist, so your best bet for style is
just to read what already exists in the handbook
(file:/usr/share/doc/handbook/handbook.html or on the FreeBSD home
page http://www.freebsd.org/handbook/handbook.html).

Also see the FreeBSD doc project page, at: 

	http://www.freebsd.org/docproj.html

Then, learn how to use SGML, the linuxdoc DTD, sgmlfmt, and start writing!

Best wishes!

-- 
Sean Kelly                          
NOAA Forecast Systems Laboratory    kelly@fsl.noaa.gov
Boulder Colorado USA                http://www-sdd.fsl.noaa.gov/~kelly/



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