From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 01:53:35 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 85CD32BF; Thu, 23 Jan 2014 01:53:35 +0000 (UTC) Received: from relay.mailchannels.net (si-004-i103.relay.mailchannels.net [198.20.121.20]) by mx1.freebsd.org (Postfix) with ESMTP id B1E821D39; Thu, 23 Jan 2014 01:53:32 +0000 (UTC) X-Sender-Id: _forwarded-from|111.125.78.19 Received: from mail-24.name-services.com (ip-10-244-196-74.us-west-2.compute.internal [10.244.196.74]) by relay.mailchannels.net (Postfix) with ESMTPA id B4CA8605CE; Thu, 23 Jan 2014 01:53:23 +0000 (UTC) X-Sender-Id: _forwarded-from|111.125.78.19 Received: from mail-24.name-services.com (mail-24.name-services.com [10.246.16.22]) (using TLSv1 with cipher AES128-SHA) by 0.0.0.0:2500 (trex/5.0.19); Thu, 23 Jan 2014 01:53:24 GMT X-MC-Relay: Forwarding X-MailChannels-SenderId: _forwarded-from%7C111.125.78.19 X-MailChannels-Auth-Id: demandmedia Received: from [192.168.111.121] (UnknownHost [111.125.78.19]) by mail-24.name-services.com with SMTP; Wed, 22 Jan 2014 17:53:15 -0800 Message-ID: <52E075F7.7020105@a1poweruser.com> Date: Thu, 23 Jan 2014 09:52:55 +0800 From: Fbsd8 User-Agent: Thunderbird 2.0.0.17 (Windows/20080914) MIME-Version: 1.0 To: gabor@FreeBSD.org Subject: Re: docs/144515: [handbook] Expand handbook Table of contents References: <201401221442.s0MEgd2o082802@freefall.freebsd.org> In-Reply-To: <201401221442.s0MEgd2o082802@freefall.freebsd.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 01:53:35 -0000 gabor@FreeBSD.org wrote: > Synopsis: [handbook] Expand handbook Table of contents > > State-Changed-From-To: open->closed > State-Changed-By: gabor > State-Changed-When: Wed Jan 22 14:37:11 UTC 2014 > State-Changed-Why: > Currently, the TOC has three levels: part, chapter and section. I am afraid > that expanding more levels would be to verbose and thus affect usability. > It is possible to download full PDF or HTML where you can use the search > functions. Alternatively, you can use the index, however it needs some > impriovements. > > > Responsible-Changed-From-To: freebsd-doc->gabor > Responsible-Changed-By: gabor > Responsible-Changed-When: Wed Jan 22 14:37:11 UTC 2014 > Responsible-Changed-Why: > Currently, the TOC has three levels: part, chapter and section. I am afraid > that expanding more levels would be to verbose and thus affect usability. > It is possible to download full PDF or HTML where you can use the search > functions. Alternatively, you can use the index, however it needs some > impriovements. > > http://www.freebsd.org/cgi/query-pr.cgi?pr=144515 I don't think you read or understood the pr. All the sub-sections are not findable, meaning there hidden. Expanding the TOC just one more level to include the sub-sections is required to make the complete contents accessible from the TOC just like any other professionally published book. I though the goal of the handbook was to be usable and here we have our main documentation looking like something created by people who don't even know the normal standard parts of a published document or the professional way to organize content. Closing this pr with the suggestion that users should use some other method to search the handbook is just ludicrous and sounds like it's nothing but a effort to shorten the open doc pr list with the least amount of work. What every happened to one's pride in one's workmanship? After the FreeBSD website isn't the handbook the second most accessed element of the FreeBSD world seen by the public? The image and reputation of FreeBSD are at stake here. This pr is very important in modernizing the handbook and should have bee opened up for discussion among all the doc members and only closed by agreement of the doc team and not out of hand by someone who in my opinion is misusing their commit privileges in this case.