pg.ddx.io  pgsql-hackers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Andrew Dunstan <andrew@dunslane.net>
To: Dimitri Fontaine <dfontaine@hi-media.com>
Cc: PostgreSQL-development <pgsql-hackers@postgresql.org>
Subject: Re: navigation menu for documents
Date: Tue, 14 Jul 2009 18:21:37 -0400
Message-ID: <4A5D04F1.4070801@dunslane.net> (raw)
In-Reply-To: <27A6A4DD-A84D-4C96-A7E1-38017070B7D1@hi-media.com>
References: <4A5CE7EB.20809@pgexperts.com>
	<27A6A4DD-A84D-4C96-A7E1-38017070B7D1@hi-media.com>

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



view thread (34+ messages)  latest in thread

Message-ID: <4A5D04F1.4070801@dunslane.net>
Permalink:  ../4A5D04F1.4070801@dunslane.net/
Also on:    postgresql.org/message-id/4A5D04F1.4070801@dunslane.net

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-hackers@postgresql.org
  Cc: andrew@dunslane.net, dfontaine@hi-media.com
  Subject: Re: navigation menu for documents
  In-Reply-To: <4A5D04F1.4070801@dunslane.net>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox