From owner-freebsd-bugbusters@FreeBSD.ORG  Thu Nov 24 06:23:50 2005
Return-Path: <owner-freebsd-bugbusters@FreeBSD.ORG>
X-Original-To: bugbusters@freebsd.org
Delivered-To: freebsd-bugbusters@FreeBSD.ORG
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 4097516A41F
	for <bugbusters@freebsd.org>; Thu, 24 Nov 2005 06:23:50 +0000 (GMT)
	(envelope-from tklopp@taponet.de)
Received: from promail.billiton.de (promail.billiton.de [213.9.47.130])
	by mx1.FreeBSD.org (Postfix) with ESMTP id AFB9143D90
	for <bugbusters@freebsd.org>; Thu, 24 Nov 2005 06:23:40 +0000 (GMT)
	(envelope-from tklopp@taponet.de)
Received: from localhost (sig9-d9bae1c9.pool.mediaWays.net [217.186.225.201])
	(authenticated bits=0)
	by promail.billiton.de (8.12.10/8.12.8) with ESMTP id jAO6NZ4A027211
	for <bugbusters@freebsd.org>; Thu, 24 Nov 2005 07:23:36 +0100
From: Tjabo Kloppenburg <tklopp@taponet.de>
Organization: The Chaos Institute
To: bugbusters@freebsd.org
Date: Thu, 24 Nov 2005 07:25:21 +0100
User-Agent: KMail/1.8.1
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-15"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200511240725.21826.tklopp@taponet.de>
X-Virus-Scanned: by amavisd-new
Cc: 
Subject: docs improvement request
X-BeenThere: freebsd-bugbusters@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "Coordination of the Problem Report handling effort."
	<freebsd-bugbusters.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-bugbusters>, 
	<mailto:freebsd-bugbusters-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-bugbusters>
List-Post: <mailto:freebsd-bugbusters@freebsd.org>
List-Help: <mailto:freebsd-bugbusters-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-bugbusters>, 
	<mailto:freebsd-bugbusters-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 24 Nov 2005 06:23:50 -0000

hi,

your bug submit form is broken.

Let me send you this change-request by email:

------------------------------------
hi,

Sorry for my bad english.

I want to suggest a change in the in-document navigation of the handbook.

Let me describe the problem:

Let's say I am reading in 
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/securing-freebsd.html
I came there by a link in another document or google.

Now I want to go two levels up.

In the current docs I've got to scroll 16 pages down (mouse wheel), to find a 
link "Up", that brings me one level up (Chapter 14), and "Home" to go 
directly to the contents page (but not at position of chapter 14).
When I chose to follow the "Up"-Links I'll never reach the contents page -- I 
get stuck in a chapter III content page without a "Home" link.

I'ld like to suggest to make the following changes:
 1. Rename "Home" link to "Content".
 2. The "Content" or "To content" link should be a link with #anchor
    target in the content page.
 3. Add navigation links at the top of each page.
    Example:
         "FreeBSD Handbook" can be a link to the content page, with local
         anchor target where chapter 14 is on the content page.
         "Chapter 14 Security": "Chapter 14" can be a link to
         http://www.freebsd.org/....859-1/books/handbook/security.html".

I think these changes would improve the usability of the handbook.

Let my say again, I am sorry for my bad english.
If you have any questions please send email.

have a nice day,
  tk.
------------------

-- 
tklopp@taponet.de
irc.freenode.net / #unixag (tapo)