pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedDocs reorganization
10+ messages / 4 participants
[nested] [flat]
* Docs reorganization
@ 2000-09-30 11:07 Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 10+ messages in thread
From: Peter Eisentraut @ 2000-09-30 11:07 UTC (permalink / raw)
To: pgsql-docs; +Cc: Thomas Lockhart <lockhart@alumni.caltech.edu>
With the extra month I'd like to do the reorganization of the docs into
one <Set>, which was discussed a while ago. Then we'd only have one HTML
set to build and don't have to ship redundant versions.
--
Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: Docs reorganization
@ 2000-09-30 14:01 Peter Eisentraut <peter_e@gmx.net>
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 2 replies; 10+ messages in thread
From: Peter Eisentraut @ 2000-09-30 14:01 UTC (permalink / raw)
To: pgsql-docs; +Cc: Thomas Lockhart <lockhart@alumni.caltech.edu>
Peter Eisentraut writes:
> With the extra month I'd like to do the reorganization of the docs into
> one <Set>, which was discussed a while ago. Then we'd only have one HTML
> set to build and don't have to ship redundant versions.
Oh well, somebody was faster... :-) When was the last time the following
was updated though?
http://www.postgresql.org/docs/postgres/index.html
If we're already at that point then we can abandon the separate user.sgml,
etc. and make links across books, right?
--
Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: Docs reorganization
@ 2000-10-04 00:54 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: Peter Eisentraut <peter_e@gmx.net>
1 sibling, 1 reply; 10+ messages in thread
From: Thomas Lockhart @ 2000-10-04 00:54 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
> If we're already at that point then we can abandon the separate user.sgml,
> etc. and make links across books, right?
Uh, I don't think so. It is unrealistic to have a 6-800 page hardcopy
doc set as a single volume, so the individual docs should continue to be
built.
- Thomas
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: Docs reorganization
@ 2000-10-04 01:20 Peter Eisentraut <peter_e@gmx.net>
parent: Thomas Lockhart <lockhart@alumni.caltech.edu>
0 siblings, 1 reply; 10+ messages in thread
From: Peter Eisentraut @ 2000-10-04 01:20 UTC (permalink / raw)
To: Thomas Lockhart <lockhart@alumni.caltech.edu>; +Cc: pgsql-docs
Thomas Lockhart writes:
> > If we're already at that point then we can abandon the separate user.sgml,
> > etc. and make links across books, right?
>
> Uh, I don't think so. It is unrealistic to have a 6-800 page hardcopy
> doc set as a single volume, so the individual docs should continue to be
> built.
I think the idea was to take the RTF file and split it at the boundaries.
If I remember right then you already tried that and considered in
workable.
Otherwise this whole change would have been pointless because now the
integrated doc looks exactly like the individual ones only with an extra
title page. Then we might as well get rid of that, but I think the intent
was to make them all into one set to enable cross-links. I can't find the
original discussion right now (no archives of pgsql-docs available?) but I
thought that was the plan.
--
Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: Docs reorganization
@ 2000-10-04 01:30 Peter Eisentraut <peter_e@gmx.net>
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 10+ messages in thread
From: Peter Eisentraut @ 2000-10-04 01:30 UTC (permalink / raw)
To: Thomas Lockhart <lockhart@alumni.caltech.edu>; +Cc: pgsql-docs
I wrote:
> I can't find the original discussion right now (no archives of
> pgsql-docs available?) but I thought that was the plan.
http://www.postgresql.org/mhonarc/pgsql-docs/2000-06/msg00024.html
--
Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: Docs reorganization
@ 2000-10-04 01:59 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 10+ messages in thread
From: Thomas Lockhart @ 2000-10-04 01:59 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
> > I can't find the original discussion right now (no archives of
> > pgsql-docs available?) but I thought that was the plan.
> http://www.postgresql.org/mhonarc/pgsql-docs/2000-06/msg00024.html
Right. I agreed to evaluate the results, but stopped short of agreeing
that this will be the One True Way.
- Thomas
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: Docs reorganization
@ 2000-10-04 20:05 Peter Eisentraut <peter_e@gmx.net>
parent: Thomas Lockhart <lockhart@alumni.caltech.edu>
0 siblings, 1 reply; 10+ messages in thread
From: Peter Eisentraut @ 2000-10-04 20:05 UTC (permalink / raw)
To: Thomas Lockhart <lockhart@alumni.caltech.edu>; +Cc: pgsql-docs
Thomas Lockhart writes:
> Right. I agreed to evaluate the results, but stopped short of agreeing
> that this will be the One True Way.
Okay, maybe I misinterpreted it. I apologize.
Anyway, let's look ahead... Seemingly the intergrated document is
somewhat redundant now, as it just combines the individual docs with a
spartanic title page. I would suggest that we instead create a nice,
representative HTML title page by hand (with elephant pic, etc.) and don't
build the integrated document separately any more. That saves disk
space/bandwidth, and confusion because of the different chapter numbering
etc. We could also put the identical title page on the website; that
would increase the overall appearance of consistency in the docs.
Also, we might want to split out the developer's guide (as opposed to
programmer's guide). The current integrated build already does that, and
it should probably happen in general, since the addressed audiences are
distinct. I think we discussed this several times already, but we never
actually laid down a decisive word.
--
Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: Docs reorganization
@ 2000-10-05 14:02 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 0 replies; 10+ messages in thread
From: Thomas Lockhart @ 2000-10-05 14:02 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
> Anyway, let's look ahead... Seemingly the intergrated document is
> somewhat redundant now, as it just combines the individual docs with a
> spartanic title page. I would suggest that we instead create a nice,
> representative HTML title page by hand (with elephant pic, etc.) and don't
> build the integrated document separately any more. That saves disk
> space/bandwidth, and confusion because of the different chapter numbering
> etc. We could also put the identical title page on the website; that
> would increase the overall appearance of consistency in the docs.
Sounds good. I would like to try the same kind of title page for the
hardcopy docs, so perhaps we can do this within the sgml (but hand-built
html for the html docs is fine too).
> Also, we might want to split out the developer's guide (as opposed to
> programmer's guide). The current integrated build already does that, and
> it should probably happen in general, since the addressed audiences are
> distinct. I think we discussed this several times already, but we never
> actually laid down a decisive word.
That would be fine. I put them together originally only because each was
fairly small. But both have grown at least a little and you are right,
they are for distinct audiences.
- Thomas
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: Re: Docs reorganization
@ 2000-10-08 00:29 The Hermit Hacker <scrappy@hub.org>
parent: Peter Eisentraut <peter_e@gmx.net>
1 sibling, 1 reply; 10+ messages in thread
From: The Hermit Hacker @ 2000-10-08 00:29 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs@postgresql.org, Thomas Lockhart <lockhart@alumni.caltech.edu>
I don't believe that that URL is applicable anymore ... Vince moved things
into the users-lounge, under a v7.0 vs v6.5.3 directory structure ...
On Sat, 30 Sep 2000, Peter Eisentraut wrote:
> Peter Eisentraut writes:
>
> > With the extra month I'd like to do the reorganization of the docs into
> > one <Set>, which was discussed a while ago. Then we'd only have one HTML
> > set to build and don't have to ship redundant versions.
>
> Oh well, somebody was faster... :-) When was the last time the following
> was updated though?
>
> http://www.postgresql.org/docs/postgres/index.html
>
> If we're already at that point then we can abandon the separate user.sgml,
> etc. and make links across books, right?
>
> --
> Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/
>
Marc G. Fournier ICQ#7615664 IRC Nick: Scrappy
Systems Administrator @ hub.org
primary: scrappy@hub.org secondary: scrappy@{freebsd|postgresql}.org
^ permalink raw reply [nested|flat] 10+ messages in thread
* Re: Re: Docs reorganization
@ 2000-10-08 01:12 Vince Vielhaber <vev@michvhf.com>
parent: The Hermit Hacker <scrappy@hub.org>
0 siblings, 0 replies; 10+ messages in thread
From: Vince Vielhaber @ 2000-10-08 01:12 UTC (permalink / raw)
To: The Hermit Hacker <scrappy@hub.org>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs@postgresql.org, Thomas Lockhart <lockhart@alumni.caltech.edu>
On Sat, 7 Oct 2000, The Hermit Hacker wrote:
>
>
> I don't believe that that URL is applicable anymore ... Vince moved things
> into the users-lounge, under a v7.0 vs v6.5.3 directory structure ...
I think the url is for the CURRENT docs. When 7.1 hits the streets a
copy of it will be put in the user's lounge.
Vince.
>
>
> On Sat, 30 Sep 2000, Peter Eisentraut wrote:
>
> > Peter Eisentraut writes:
> >
> > > With the extra month I'd like to do the reorganization of the docs into
> > > one <Set>, which was discussed a while ago. Then we'd only have one HTML
> > > set to build and don't have to ship redundant versions.
> >
> > Oh well, somebody was faster... :-) When was the last time the following
> > was updated though?
> >
> > http://www.postgresql.org/docs/postgres/index.html
> >
> > If we're already at that point then we can abandon the separate user.sgml,
> > etc. and make links across books, right?
> >
> > --
> > Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/
> >
>
> Marc G. Fournier ICQ#7615664 IRC Nick: Scrappy
> Systems Administrator @ hub.org
> primary: scrappy@hub.org secondary: scrappy@{freebsd|postgresql}.org
>
>
--
==========================================================================
Vince Vielhaber -- KA8CSH email: vev@michvhf.com http://www.pop4.net
128K ISDN from $22.00/mo - 56K Dialup from $16.00/mo at Pop4 Networking
Online Campground Directory http://www.camping-usa.com
Online Giftshop Superstore http://www.cloudninegifts.com
==========================================================================
^ permalink raw reply [nested|flat] 10+ messages in thread
end of thread, other threads:[~2000-10-08 01:12 UTC | newest]
Thread overview: 10+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2000-09-30 11:07 Docs reorganization Peter Eisentraut <peter_e@gmx.net>
2000-09-30 14:01 ` Peter Eisentraut <peter_e@gmx.net>
2000-10-04 00:54 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2000-10-04 01:20 ` Peter Eisentraut <peter_e@gmx.net>
2000-10-04 01:30 ` Peter Eisentraut <peter_e@gmx.net>
2000-10-04 01:59 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2000-10-04 20:05 ` Peter Eisentraut <peter_e@gmx.net>
2000-10-05 14:02 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2000-10-08 00:29 ` The Hermit Hacker <scrappy@hub.org>
2000-10-08 01:12 ` Vince Vielhaber <vev@michvhf.com>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox