Date: Mon, 18 Feb 2002 19:45:00 -0500 From: Tom Rhodes <darklogik@pittgoth.com> To: Michael Lucas <mwlucas@blackhelicopters.org> Cc: Jay Edwards <jayed@jayed.com>, bmah@FreeBSD.ORG, freebsd-doc@FreeBSD.ORG Subject: Re: BSDCon Doc BoF Notes Message-ID: <3C71A00C.1010007@pittgoth.com> References: <200202182315.g1INFpc93221@bmah.dyndns.org> <3C719161.5090803@pittgoth.com> <20020219050357.GN42451@jayed.com> <20020218191647.A11924@blackhelicopters.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Michael Lucas wrote: >Well, when you print it out, the existing Handbook is about 700 pages. >This is a bit hefty for a book on "general systems administration." >If it wasn't going to grow any more, we wouldn't worry. > >The Handbook does grow, however. Do we want the 3rd print edition to >be 1200 pages? Probably not. Although this is a volunteer project, >we do need to consider the needs of our corporate sponsors. FreeBSD >Mall put a lot of work into the Handbook's dead tree edition, and >dumps that money right back into FreeBSD. IMHO, this makes their >desires at least worth considering. > >The two major proposals were: > >a) chop the Handbook in half. > >b) chop the Handbook into several smaller manuals: the Installation >Handbook, the Networking Handbook, etc. > >After some pondering, I like option b. The apparent "difficulty of >entry" for new -doc committers would be reduced. Smaller books would >be easier to handle and edit. > >Right now, you can tell that people tried to work on the grammar in >the Handbook. Along about Chapter 10 or 11, they gave up. It's just >too big for a volunteer effort. While smaller books would contain no >less data, they would be easier for volunteers to manage. > >Of course, other suggestions are welcome. This bikeshed is going to >be around a while, I'm afraid. > >==ml > > > I like this idea. The splitting of the handbook down to either smaller books and/or articles would be very beneficial for most of the current readers and contributers. Less to maintain, less to read, more specific documentation on various subjects. This may even help to keep down the amount of mistakes. This is something that I feel should be pushed, but lets hear more opinion... --Tom Rhodes To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?3C71A00C.1010007>