From owner-freebsd-doc Thu May 16 21:45:53 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id VAA10595 for doc-outgoing; Thu, 16 May 1996 21:45:53 -0700 (PDT) Received: from pop01.ny.us.ibm.net (pop01.ny.us.ibm.net [165.87.194.251]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id VAA10589 for ; Thu, 16 May 1996 21:45:49 -0700 (PDT) Received: (from mail@localhost) by pop01.ny.us.ibm.net (8.6.9/8.6.9) id EAA246706; Fri, 17 May 1996 04:45:48 GMT Message-Id: <199605170445.EAA246706@pop01.ny.us.ibm.net> From: "Francisco Reyes" To: "FreeBSD doc Mailing list" Date: Fri, 17 May 96 00:44:28 -0400 Reply-To: "Francisco Reyes" Priority: Normal X-Mailer: Francisco Reyes's Registered PMMail 1.5 MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Subject: Getting ready to help Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk As I mentioned in a message some days back in a few weeks I will time to help with the documentation. Right now I am spending a little time here and there and making some comments. I am hoping to help much more than that when I finish the semester (before my summer classes begin of course). Some of the things I will need to know are: - Is it ok if I send html? If sgml is prefered where can I get hold of the sgml of the existing pages to change them and where can I get references to coding in sgml. - If I merely have suggestions to a page should I just send the suggestions or should I send a revised copy? Is diff covered in the man pages? I have read some emails saying to use diff (I will check the man page when I boot Freebsd later, till I get sendmail running and the news server I am using OS/2) - Some of the pages I have seen in the handbook have asterisks. An example is the list of compatible cards. Any reason those sections have not been started? If the main problem is time perhaps we could start getting people to send me their configurations now and when I have more time I will make the html pages. One possible way is to ask people to help us by sending the data in a formated way so that I can write a small program to parse it and create the html/sgml automatically. -When I give suggestions is it good to give the reason why I am suggesting them? Some of the messages I have written recently seemed a bit large and I figure many may have already to much to read so, me making the messages long may be inconvienient for others.