Re: [GENERAL] documentation suggestion

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: Rob Sargent <robjsargent(at)gmail(dot)com>, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: [GENERAL] documentation suggestion
Date: 2011-09-01 11:53:39
Message-ID: 201109011153.p81BrdG11326@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-general

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(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

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

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Kevin Grittner 2011-09-01 13:52:38 Re: The translation into Bulgarian
Previous Message Albert Ward 2011-09-01 01:07:26 The translation into Bulgarian

Browse pgsql-general by date

  From Date Subject
Next Message Sim Zacks 2011-09-01 12:10:22 Re: md5 of table
Previous Message Marcos Hercules Santos 2011-09-01 11:49:29 Re: function on trigger