From owner-freebsd-doc Sat Aug 26 05:16:43 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id FAA15662 for doc-outgoing; Sat, 26 Aug 1995 05:16:43 -0700 Received: from time.cdrom.com (time.cdrom.com [192.216.222.226]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id FAA15656 for ; Sat, 26 Aug 1995 05:16:41 -0700 Received: (from jkh@localhost) by time.cdrom.com (8.6.12/8.6.9) id FAA29053 for doc@freefall; Sat, 26 Aug 1995 05:16:38 -0700 Date: Sat, 26 Aug 1995 05:16:38 -0700 From: "Jordan K. Hubbard" Message-Id: <199508261216.FAA29053@time.cdrom.com> To: doc@freefall.FreeBSD.org Subject: "too many notes" Sender: doc-owner@FreeBSD.org Precedence: bulk If those of you who will recall the movie "Amadeus" remember.. Well, I fear that I must echo similar sentiments concerning the Handbook when I say "too many sections." I'll explain. Having gotten my third complaint that "the Handbook looked really nice but, was, well. ahem. too *split up*! One paragraph per section is too small! :(" I finally went to investigate those complaints.. Reading through the handbook myself, I have begun to reluctantly concur with these assessments. It really is fairly hard to use in parts. Perhaps much of this stems simply from the fact that we're not done yet and all of this is going to get filled in later, but there are sections which seem fairly complete but are yet rather small to be out on their own. We could also probably stand to collapse some of the chapters together so as to have more material easily accessible in one place, but that's up to John. What do others think? JOrdan