From: Bruce Momjian <bruce@momjian.us>
Message-Id: <201109011153.p81BrdG11326@momjian.us>
Subject: Re: [GENERAL] documentation suggestion
In-Reply-To: <1314477260.2349.35.camel@vanquo.pezone.net>
To: Peter Eisentraut <peter_e@gmx.net>
Date: Thu, 1 Sep 2011 07:53:39 -0400 (EDT)
CC: Rob Sargent <robjsargent@gmail.com>,
	PostgreSQL-documentation <pgsql-docs@postgresql.org>
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="US-ASCII"

Peter Eisentraut wrote:
> > > > 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?

In that case, the text "Chapter 7. Queries" should be click-able and act
as "up".  If you want to put "(Up)" after the title, that's fine too.

-- 
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + It's impossible for everything to be true. +