Return to BSD News archive
Path: sserve!newshost.anu.edu.au!harbinger.cc.monash.edu.au!simtel!zombie.ncsc.mil!news.mathworks.com!uhog.mit.edu!news.mtholyoke.edu!news.smith.edu!jfieber From: jfieber@grendel.csc.smith.edu (John Fieber) Newsgroups: comp.unix.bsd.freebsd.misc Subject: Re: Documentation project (was Re: Slight flame from Linux user) Date: 19 Jun 1995 23:39:01 GMT Organization: Smith College, Northampton, MA, USA Lines: 20 Message-ID: <3s51ql$mjt@sylvia.smith.edu> References: <3ql3gd$je2@bell.maths.tcd.ie> <3rqdbg$q1u@hamilton.maths.tcd.ie> <DAA2IF.EpA@midway.uchicago.edu> <3rt3sv$pij@bell.maths.tcd.ie> NNTP-Posting-Host: grendel.csc.smith.edu In article <3rt3sv$pij@bell.maths.tcd.ie>, Timothy Murphy <tim@maths.tcd.ie> wrote: >But the proof of the pudding is in the eating. >The FreeBSD "handbook" is certainly not very readable at the moment. And the reason is that about 80% of the content is formerly stand-alone documents that were just pulled in with little if any editing. I believe that a manual written by many writers /can/ be quite smooth and readable, but only through the toil of a few good editors. With the handbook, I've tried to create an outline of topics that should be covered in an effort to direct some of the creative energy of would be writers. The sections of the current handbook that pre-date the creation of this framework need a lot more editing to make them fit in than those that came later. -john -- === jfieber@cs.smith.edu ========== Come up and be a kite! --K. Bush ===