From owner-freebsd-doc Tue Apr 16 08:41:42 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id IAA19944 for doc-outgoing; Tue, 16 Apr 1996 08:41:42 -0700 (PDT) Received: from fslg8.fsl.noaa.gov (fslg8.fsl.noaa.gov [137.75.131.171]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id IAA19936 for ; Tue, 16 Apr 1996 08:41:39 -0700 (PDT) Received: by fslg8.fsl.noaa.gov (5.57/Ultrix3.0-C) id AA09509; Tue, 16 Apr 96 15:41:27 GMT Message-Id: <9604161541.AA09509@fslg8.fsl.noaa.gov> Received: by emu.fsl.noaa.gov (1.40.112.3/16.2) id AA105319337; Tue, 16 Apr 1996 09:42:17 -0600 Date: Tue, 16 Apr 1996 09:42:17 -0600 From: Sean Kelly To: J.P.Jansen@net.hcc.nl Cc: doc@freebsd.org In-Reply-To: <9604151857.AA03342@solair1.inter.NL.net> (J.P.Jansen@net.hcc.nl) Subject: Re: documentation project Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk >>>>> "Jos" == J P Jansen 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/