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-08-25 03:40:45
Message-ID: 201108250340.p7P3ejO12408@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-general

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

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

In response to

Responses

Browse pgsql-docs by date

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

Browse pgsql-general by date

  From Date Subject
Next Message Adarsh Sharma 2011-08-25 04:03:38 Links to Replication
Previous Message Ondrej Ivanič 2011-08-25 02:44:23 Re: Indexes on inheriting tables