From owner-freebsd-doc Mon Feb 18 15:32: 3 2002 Delivered-To: freebsd-doc@freebsd.org Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by hub.freebsd.org (Postfix) with ESMTP id 0983637B400; Mon, 18 Feb 2002 15:31:58 -0800 (PST) Received: from pittgoth.com (lcl234.zbzoom.net [208.236.36.234]) by pittgoth.com (8.11.6/8.11.6) with ESMTP id g1INXhv16305; Mon, 18 Feb 2002 18:33:44 -0500 (EST) (envelope-from darklogik@pittgoth.com) Message-ID: <3C719161.5090803@pittgoth.com> Date: Mon, 18 Feb 2002 18:42:25 -0500 From: Tom Rhodes Reply-To: darklogik@pittgoth.com User-Agent: Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.7) Gecko/20011221 X-Accept-Language: en-us MIME-Version: 1.0 To: bmah@FreeBSD.ORG Cc: freebsd-doc@FreeBSD.ORG Subject: Re: BSDCon Doc BoF Notes References: <200202182315.g1INFpc93221@bmah.dyndns.org> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Bruce A. Mah wrote: > More mid-range plans: Split up the handbook. Issue here is to go to > a lot of smaller books or a few larger ones. Lots of smaller books is > like the Linux HOWTO project (Bob Bruce: Can we leverage the Linux > HOWTOs? No solid answer to this.) Big books raise the barriers to > entry for new contributers, and are hard to navigate (on the other > hand, indexes are more useful). Paul Richards: Small books give us > the ability to do incremental updates to printed documentation or at > least make it more feasible. > Can I suggest, the division of the hanbook. I can see where the handbook can be divided between home user and like corp user. Mainly the reasons for this is most home users may not need to know things like apache configuration, or sendmail configuration. Just use the ISP's mail server for email. I am sure many other aspects can be worked with here, but these poped up first. I would like to hear comments on this idea, the 'vision' of handbook breakup may be different depending on who is looking at it. For this reason I feel more comments than mine should be stated. > Another item: Find a better search engine for the Web site. > > Back to Murray's slides: Problems known with the second-edition > Handbook: No sections on wireless networking or DVD/multimedia, IPsec > section seems to be unusable by people who have tried to use it, > grammar is horrible. Wants more constructive criticism, but people > aren't giving much, not clear why. Michael Lucas: Many of the > problems can be summed up as, "It's not enough to write to be > understood; you have to write so that you cannot be misunderstood". Hasn't Michael stated this many times over in the past ;) Should we add it to the FDP primer? > Generally accepted that many contributors to the Handbook (many of > whom are not professional writers) will cause this problem. Maybe > needs a copy editor? Murray: PRs pointing out specific problems are > welcomed, even if there's no patch. True, mainly because the various amount of people here seem to patch at and work at a nice rate. Always love looking over the pr database and thinking what to tackle next ;) > > About this time, kicked out of the room by the next BOF. > You were kicked out of the room? Pretty... -- Tom (Darklogik) Rhodes www.Pittgoth.com Gothic Liberation Front www.FreeBSD.org The Power To Serve To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message