From: Thomas Lockhart <lockhart@alumni.caltech.edu>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: pgsql-docs@postgresql.org
Subject: Re: Docs reorganization
Date: Thu, 05 Oct 2000 14:02:00 +0000
Message-ID: <39DC89D8.FCD05467@alumni.caltech.edu> (raw)
References: <Pine.LNX.4.21.0010042155410.934-100000@peter.localdomain>
> 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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: lockhart@alumni.caltech.edu, peter_e@gmx.net
Subject: Re: Docs reorganization
In-Reply-To: <39DC89D8.FCD05467@alumni.caltech.edu>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
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