Message-ID: <4A5D04F1.4070801@dunslane.net>
Date: Tue, 14 Jul 2009 18:21:37 -0400
From: Andrew Dunstan <andrew@dunslane.net>
User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US;
	rv:1.8.0.12) Gecko/20071019 Fedora/1.0.9-3.fc6 pango-text
	SeaMonkey/1.0.9
MIME-Version: 1.0
To: Dimitri Fontaine <dfontaine@hi-media.com>
CC: PostgreSQL-development <pgsql-hackers@postgresql.org>
Subject: Re: navigation menu for documents
References: <4A5CE7EB.20809@pgexperts.com>
	<27A6A4DD-A84D-4C96-A7E1-38017070B7D1@hi-media.com>
In-Reply-To: <27A6A4DD-A84D-4C96-A7E1-38017070B7D1@hi-media.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit

Dimitri Fontaine wrote:
> Hi,
>
> Le 14 juil. 09 à 22:17, Andrew Dunstan a écrit :
>> For a very long time I have thought that it would be useful to have 
>> some sort of navigation menu for the docs
>
> Oh yes, pretty please :)
>
>> Navigating the docs requires far too much use of the back button and 
>> up links, IMNSHO. A menu frame would make them far more usable.
>
> No, please, no frame! Really...

Yes, really. What you suggest here is just not adequate, IMNSHO. I don't 
want to have to scroll to the top or bottom of the page to get 
navigation, and I want to be able to see the navigation and go where I 
want directly.

I know some people have a violent aversion to frames, but I don't. They 
have legitimate uses.

>
> What I'm thinking about is to extend current "breadcumb" at the top of 
> the page to include chapter, section, subsection. So that for exemple 
> the following page:
>   
> http://www.postgresql.org/docs/8.3/interactive/datatype-geometric.html#AEN5480 
>
>
> Would have at its top:
>   Home → Documentation → Manuals → PostgreSQL 8.3 → Data Types → 
> Geometric Types → Points
>
> Well the last entry, Points, I'm not so sure about. But I think you 
> get the idea.
>


Compared with what things like doxygen or webhelp give you it's not 
remotely what I want.

cheers

andrew