From: Joshua D. Drake <jd@commandprompt.com>
To: Fabien COELHO <coelho@cri.ensmp.fr>
Cc: PostgreSQL Developers <pgsql-hackers@postgresql.org>
Subject: Re: Documentation epub format
Date: Wed, 01 May 2013 09:33:23 -0700
Message-ID: <518143D3.8060007@commandprompt.com> (raw)
In-Reply-To: <alpine.DEB.2.02.1305011144590.25330@localhost6.localdomain6>
References: <alpine.DEB.2.02.1305011144590.25330@localhost6.localdomain6>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-hackers>
On 05/01/2013 09:27 AM, Fabien COELHO wrote:
>
>
> Hello devs,
>
> I've given a try to the PostgreSQL documentation in epub format.
>
> I must admit that there is a bit of a disappointement as far as the user
> experience is concerned: the generated file is barely usable on an iPad2
> with the default iBooks reader, which was clearly not designed for
> handling a "4592" pages book (from its point of view).
>
> The table of contents too much detailed, so it is long and slow to scan,
> and there is no clear shortcut. Flipping pages in the documentation
> takes ages (well, close to one second or more if I flip a few pages). Do
> not try "search".
>
> 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.
JD
--
Command Prompt, Inc. - http://www.commandprompt.com/
PostgreSQL Support, Training, Professional Services and Development
High Availability, Oracle Conversion, Postgres-XC
@cmdpromptinc - 509-416-6579
--
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: jd@commandprompt.com, coelho@cri.ensmp.fr, pgsql-hackers@postgresql.org
Subject: Re: Documentation epub format
In-Reply-To: <518143D3.8060007@commandprompt.com>
* 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