From: Bruce Momjian <bruce@momjian.us>
To: Fabien COELHO <coelho@cri.ensmp.fr>
Cc: Joshua D. Drake <jd@commandprompt.com>
Cc: PostgreSQL Developers <pgsql-hackers@postgresql.org>
Subject: Re: Documentation epub format
Date: Fri, 3 May 2013 09:30:53 -0400
Message-ID: <20130503133053.GH5933@momjian.us> (raw)
In-Reply-To: <alpine.DEB.2.02.1305030747140.9292@localhost6.localdomain6>
References: <alpine.DEB.2.02.1305011144590.25330@localhost6.localdomain6>
<518143D3.8060007@commandprompt.com>
<alpine.DEB.2.02.1305030747140.9292@localhost6.localdomain6>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-hackers>
On Fri, May 3, 2013 at 07:57:07AM +0200, Fabien COELHO wrote:
>
> >>This seems to suggest that instead of generating one large ebook, the
> >>build should generate a set of ebooks, say one for each part. At the
> >>minimum, a less detailed toc could be more usable and help navigate the
> >>huge contents.
> >
> >Once upon a time we had multiple books as documentation, then at
> >some point we merged them. It was quite a few years ago.
> >
> >I would agree at this point that we need to consider breaking them
> >up again. The documentation is unwieldy.
>
> PostgreSQL documentation in PDF seemed quite usable on the same
> ipad, so maybe there is no unique answer. I like the principle and
> simplicity of "one" document to move around, so sticking to that if
> possible seems better.
No question that PDF readers with collapsable index sections is a huge
win for our documentation. It isn't really the docs itself that control
that.
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ It's impossible for everything to be true. +
--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers
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: bruce@momjian.us, coelho@cri.ensmp.fr, jd@commandprompt.com, pgsql-hackers@postgresql.org
Subject: Re: Documentation epub format
In-Reply-To: <20130503133053.GH5933@momjian.us>
* 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