Subject: Re: [GENERAL] documentation suggestion
From: Peter Eisentraut <peter_e@gmx.net>
To: Bruce Momjian <bruce@momjian.us>
Cc: Rob Sargent <robjsargent@gmail.com>, PostgreSQL-documentation
	<pgsql-docs@postgresql.org>
In-Reply-To: <201108250340.p7P3ejO12408@momjian.us>
References: <201108250340.p7P3ejO12408@momjian.us>
Content-Type: text/plain; charset="UTF-8"
Date: Sat, 27 Aug 2011 23:34:20 +0300
Message-ID: <1314477260.2349.35.camel@vanquo.pezone.net>
Mime-Version: 1.0
Content-Transfer-Encoding: 7bit

On ons, 2011-08-24 at 23:40 -0400, Bruce Momjian wrote:
> Peter Eisentraut wrote:
> > On ons, 2011-08-24 at 08:33 -0400, Bruce Momjian wrote:
> > > Rob Sargent wrote:
> > > > 
> > > > 
> > > > Bruce Momjian wrote:
> > > > > Rob Sargent wrote:
> > > > >   
> > > > >> Apologies if this is the wrong forum.
> > > > >>
> > > > >> If there has been a suggestion to get the "Up" hyperlink placed also
> > > > >> at/near the top of the page, please add my vote. Else could this be
> > > > >> considered as a feature request?
> > > > >>     
> > > > >
> > > > > I have talked to Peter Eisentraut on several occasions during the past
> > > > > nine months requesting these changes.  Peter, can you make this change
> > > > > or give me a hint on how I can do it?
> > > > >
> > > > >   
> > > > Is the build system of the web-site also downloadable? I could possibly 
> > > > take a peek. (In a couple of weeks, that is. Vaction.)
> > > 
> > > [ Discussion moved to docs ]
> > > 
> > > Yes, it is all online in doc/src/sgml.  I think the file that needs to
> > > be modified is stylesheet.dsl.
> > 
> > We did play around with it, but none of the solutions looked satisfying.
> > 
> > Where exactly would you want the "Up" to be placed?
> 
> Here is my request from Feb 2, 2011:
> 
> 	Peter, based on feedback we have received, I think our users want our
> 	docs header to look the same as our docs footer, i.e. few people see
> 	the value of Fast Forward and Fast Backward, and they want "Up" to be in
> 	the header.  You seem to have done all the substantive changes to
> 	stylesheet.dsl --- would you make these changes?  Thanks.
> 
> and from March 11:
> 
> 	OK, so here is a summary:
> 
> 	      o  remove fast forward/backward links
> 	      o  add book title where there is no heading
> 	      o  make book and chapter titles as links
> 	      o  make the bottom footer match the top header
> 
> Not sure which suggestion you want but anything that adds "Up"
> functionality, either with the "Up" literal or the chapter title that is
> "up" would be an improvement.

Yes, but where do you want the "Up" placed?

Take a random page, such as this one:
http://developer.postgresql.org/pgdocs/postgres/queries-table-expressions.html

Where should the "Up" at the top go?