From owner-freebsd-doc Thu May 16 22:58:52 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id WAA16919 for doc-outgoing; Thu, 16 May 1996 22:58:52 -0700 (PDT) Received: from genesis.atrad.adelaide.edu.au (genesis.atrad.adelaide.edu.au [129.127.96.120]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id WAA16912 for ; Thu, 16 May 1996 22:58:48 -0700 (PDT) Received: from msmith@localhost by genesis.atrad.adelaide.edu.au (8.6.12/8.6.9) id PAA10693; Fri, 17 May 1996 15:39:37 +0930 From: Michael Smith Message-Id: <199605170609.PAA10693@genesis.atrad.adelaide.edu.au> Subject: Re: Getting ready to help To: reyes01@ibm.net Date: Fri, 17 May 1996 15:39:37 +0930 (CST) Cc: doc@FreeBSD.ORG In-Reply-To: <199605170445.EAA246706@pop01.ny.us.ibm.net> from "Francisco Reyes" at May 17, 96 00:44:28 am MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-doc@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk Francisco Reyes stands accused of saying: > > 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. All the SGML for the handbook is in /usr/share/doc/handbook; that should be a pretty good reference to start with 8) > - If I merely have suggestions to a page should I just send the > suggestions or should I send a revised copy? Is diff covered That depends on the nature of the change - if it's just a few words, just send the difference. If it's a rewrite of a whole section, send the lot 8) > - 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 Lack of resources 8( > 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. A sort of semiautomatic 'this hardware works' submission? Sounds good. > -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. Not at all. Long messages full of crap are inconvenient, but so far you're making pretty good sense. Thanks! -- ]] Mike Smith, Software Engineer msmith@atrad.adelaide.edu.au [[ ]] Genesis Software genesis@atrad.adelaide.edu.au [[ ]] High-speed data acquisition and (GSM mobile) 0411-222-496 [[ ]] realtime instrument control (ph/fax) +61-8-267-3039 [[ ]] Collector of old Unix hardware. "Where are your PEZ?" The Tick [[