From owner-freebsd-doc Fri May 17 09:55:05 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id JAA01486 for doc-outgoing; Fri, 17 May 1996 09:55:05 -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 JAA01481 for ; Fri, 17 May 1996 09:55:03 -0700 (PDT) Received: by fslg8.fsl.noaa.gov (5.57/Ultrix3.0-C) id AA05564; Fri, 17 May 96 16:54:40 GMT Message-Id: <9605171654.AA05564@fslg8.fsl.noaa.gov> Received: by emu.fsl.noaa.gov (1.40.112.3/16.2) id AA220432082; Fri, 17 May 1996 10:54:42 -0600 Date: Fri, 17 May 1996 10:54:42 -0600 From: Sean Kelly To: reyes01@ibm.net Cc: doc@freebsd.org In-Reply-To: <199605170445.EAA246706@pop01.ny.us.ibm.net> (reyes01@ibm.net) Subject: Re: Getting ready to help Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk >>>>> "Francisco" == "Francisco Reyes" writes: Francisco> Some of the things I will need to know are: - Is it ok Francisco> if I send html? If sgml is prefered where can I get Francisco> hold of the sgml of the existing pages to change them Francisco> and where can I get references to coding in sgml. SGML would definitely be preferred. You can get the SGML source of the existing pages in /usr/src/share/doc/handbook or on the web at http://www.freebsd.org/cgi-bin/cvsweb/src/share/doc/handbook/ Francisco> - Some of the pages I have seen in the handbook have Francisco> asterisks. An example is the list of compatible Francisco> cards. Any reason those sections have not been started? Not enough time or people to write 'em up. Francisco> If the main problem is time perhaps we could start Francisco> getting people to send me their configurations now and Francisco> when I have more time I will make the html pages. One Francisco> possible way is to ask people to help us by sending the Francisco> data in a formated way so that I can write a small Francisco> program to parse it and create the html/sgml Francisco> automatically. Sounds great! Francisco> -When I give suggestions is it good to give the reason Francisco> why I am suggesting them? Some of the messages I have Francisco> written recently seemed a bit large and I figure many Francisco> may have already to much to read so, me making the Francisco> messages long may be inconvienient for others. It depends on the kind of suggestion. Correcting grammar probably needs no comment, but the author of a document may be more willing to accept a restructuring of a series of paragraphs if you give reasons why. -- Sean Kelly NOAA Forecast Systems Laboratory kelly@fsl.noaa.gov Boulder Colorado USA http://www-sdd.fsl.noaa.gov/~kelly/