public inbox for [email protected]  
help / color / mirror / Atom feed
Contents page - usability suggestion
4+ messages / 2 participants
[nested] [flat]

* Contents page - usability suggestion
@ 2005-09-08 20:05  Richard Huxton <[email protected]>
  0 siblings, 2 replies; 4+ messages in thread

From: Richard Huxton @ 2005-09-08 20:05 UTC (permalink / raw)
  To: pgsql-docs

I do try and be good and look up manual references where I think they're 
useful to people on the mailing lists, and one small thing makes this 
harder than I think it needs to be.

If you go to the main contents page on any of the recent manuals 
(.../index.html) and hit "End" to go to the bottom of the page you don't 
  see the Index or Appendices, you get the bottom-half of "List of xxx".

Is it difficult to put these sections on separate pages?
Is it a bad idea?

I sympathise if people don't like tinkering with the doc generation 
stuff - I remember trying to get some Jade setup working on RH8 and I 
still wake up screaming...
-- 
   Richard Huxton
   Archonet Ltd



^ permalink  raw  reply  [nested|flat] 4+ messages in thread

* Re: Contents page - usability suggestion
@ 2005-09-08 20:20  Peter Eisentraut <[email protected]>
  parent: Richard Huxton <[email protected]>
  1 sibling, 1 reply; 4+ messages in thread

From: Peter Eisentraut @ 2005-09-08 20:20 UTC (permalink / raw)
  To: Richard Huxton <[email protected]>; +Cc: pgsql-docs

Richard Huxton wrote:
> Is it difficult to put these sections on separate pages?

Yes.

> Is it a bad idea?

No.

We could simply get rid of them (rather than trying to move them 
somewhere else), which I would personally support.

-- 
Peter Eisentraut
http://developer.postgresql.org/~petere/



^ permalink  raw  reply  [nested|flat] 4+ messages in thread

* Re: Contents page - usability suggestion
@ 2005-09-08 20:26  Richard Huxton <[email protected]>
  parent: Richard Huxton <[email protected]>
  1 sibling, 0 replies; 4+ messages in thread

From: Richard Huxton @ 2005-09-08 20:26 UTC (permalink / raw)
  To: Richard Huxton <[email protected]>; +Cc: pgsql-docs

Richard Huxton wrote:
> I do try and be good and look up manual references where I think they're 
> useful to people on the mailing lists, and one small thing makes this 
> harder than I think it needs to be.

Not wanting to make a habit of replying to myself, but while I'm 
throwing out ideas without researching them first...

If you moved "Internals" before "Reference" you'd have almost all the 
reference/list-based stuff together at the very end.

-- 
   Richard Huxton
   Archonet Ltd



^ permalink  raw  reply  [nested|flat] 4+ messages in thread

* Re: Contents page - usability suggestion
@ 2005-09-08 20:34  Richard Huxton <[email protected]>
  parent: Peter Eisentraut <[email protected]>
  0 siblings, 0 replies; 4+ messages in thread

From: Richard Huxton @ 2005-09-08 20:34 UTC (permalink / raw)
  To: Peter Eisentraut <[email protected]>; +Cc: pgsql-docs

Peter Eisentraut wrote:
> Richard Huxton wrote:
> 
>>Is it difficult to put these sections on separate pages?
> 
> Yes.

I feared as much.

>>Is it a bad idea?
> 
> 
> No.
> 
> We could simply get rid of them (rather than trying to move them 
> somewhere else), which I would personally support.

If that's the decision, I'd be happy to put in the effort to make sure 
the index covers everything useful out of the various lists. I'd need to 
know soon or in a couple of weeks though. Off on honeymoon next week and 
my new wife is understanding, but not *that* understanding...

--
   Richard Huxton
   Archonet Ltd




^ permalink  raw  reply  [nested|flat] 4+ messages in thread


end of thread, other threads:[~2005-09-08 20:34 UTC | newest]

Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2005-09-08 20:05 Contents page - usability suggestion Richard Huxton <[email protected]>
2005-09-08 20:20 ` Peter Eisentraut <[email protected]>
2005-09-08 20:34   ` Richard Huxton <[email protected]>
2005-09-08 20:26 ` Richard Huxton <[email protected]>

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox