Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 23 Jan 2014 09:52:55 +0800
From:      Fbsd8 <fbsd8@a1poweruser.com>
To:        gabor@FreeBSD.org
Cc:        freebsd-doc@FreeBSD.org
Subject:   Re: docs/144515: [handbook] Expand handbook Table of contents
Message-ID:  <52E075F7.7020105@a1poweruser.com>
In-Reply-To: <201401221442.s0MEgd2o082802@freefall.freebsd.org>
References:  <201401221442.s0MEgd2o082802@freefall.freebsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help
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.





Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?52E075F7.7020105>