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

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

--
  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: Josh Kupershmidt
Date:
Subject: sgml cleanup: unescaped '>' characters
Next
From: Peter Eisentraut
Date:
Subject: Re: Make man on CentOS 5.6