Bug 144515

Summary: [handbook] Expand handbook Table of contents
Product: Documentation Reporter: aiza <aiza21>
Component: Books & ArticlesAssignee: Gabor Kovesdan <gabor>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description aiza 2010-03-07 01:00:03 UTC 
The handbook TOC 'Table of Contents' is incomplete. It is missing sub-section topic listings. 

It very hard to find the subject one is looking for in the handbook. The TOC only gets me to the general area in the handbook and then I have to (next page) through it looking for what I hope is there.

The TOC really needs to be expanded to display each and every sub-section topic of all the major sections now in the TOC.

For example Installing from a "ms/dos partition" or "splash screen usage".

These are both subjects in the handbook but are not in the TOC.
What good is am TOC that does not index its content?

The purpose of the TOC is to list all subjects documented in the handbook so the reader can skim through the TOC and click on the exact subject they want to read. Can not do that with the current handbook TOC.

Fix: 

Rebuild the TOC by adding links to every sub-section topic in the handbook.
Comment 1 Gabor Kovesdan freebsd_committer freebsd_triage 2014-01-22 14:37:11 UTC 
State Changed
From-To: open->closed

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.
Comment 2 Gabor Kovesdan freebsd_committer freebsd_triage 2014-01-22 14:37:11 UTC 
Responsible Changed
From-To: freebsd-doc->gabor

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.