Re: [GENERAL] documentation suggestion

From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: Rob Sargent <robjsargent(at)gmail(dot)com>, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: [GENERAL] documentation suggestion
Date: 2011-08-27 20:34:20
Message-ID: 1314477260.2349.35.camel@vanquo.pezone.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-general

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?

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Eisentraut 2011-08-27 20:48:45 Re: sgml cleanup: unescaped '>' characters
Previous Message Peter Eisentraut 2011-08-27 20:30:43 Re: Make man on CentOS 5.6

Browse pgsql-general by date

  From Date Subject
Next Message Darren Duncan 2011-08-27 20:48:43 Re: Still no way to install PostGres on os x Lion?
Previous Message Kenneth McDonald 2011-08-27 20:27:46 Still no way to install PostGres on os x Lion?