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

From Peter Eisentraut
Subject Re: [GENERAL] documentation suggestion
Date
Msg-id 1314477260.2349.35.camel@vanquo.pezone.net
Whole thread Raw
In response to Re: [GENERAL] documentation suggestion  (Bruce Momjian <bruce@momjian.us>)
Responses Re: [GENERAL] documentation suggestion
List pgsql-docs
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?



pgsql-docs by date:

Previous
From: Peter Eisentraut
Date:
Subject: Re: Make man on CentOS 5.6
Next
From: Peter Eisentraut
Date:
Subject: Re: sgml cleanup: unescaped '>' characters