Re: [GENERAL] documentation suggestion - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: [GENERAL] documentation suggestion
Date
Msg-id 201109011153.p81BrdG11326@momjian.us
Whole thread Raw
In response to Re: [GENERAL] documentation suggestion  (Peter Eisentraut <peter_e@gmx.net>)
List pgsql-docs
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. +

pgsql-docs by date:

Previous
From: "Albert Ward"
Date:
Subject: The translation into Bulgarian
Next
From: "Kevin Grittner"
Date:
Subject: Re: The translation into Bulgarian