Обсуждение: Re: [GENERAL] documentation suggestion

Поиск
Список
Период
Сортировка

Re: [GENERAL] documentation suggestion

От
Bruce Momjian
Дата:
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.

--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

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

Re: [GENERAL] documentation suggestion

От
Peter Eisentraut
Дата:
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?




Re: [GENERAL] documentation suggestion

От
Bruce Momjian
Дата:
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. +

Re: [GENERAL] documentation suggestion

От
Peter Eisentraut
Дата:
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?



Re: [GENERAL] documentation suggestion

От
Bruce Momjian
Дата:
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@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

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