From: Craig Ringer <craig@2ndquadrant.com>
To: Andrew Satori <dru@druware.com>
Cc: PostgreSQL Developers <pgsql-docs@postgresql.org>
Subject: Re: [HACKERS] Documentation epub format
Date: Thu, 02 May 2013 12:45:41 +0800
Message-ID: <5181EF75.8070208@2ndquadrant.com> (raw)
In-Reply-To: <C27F1394-77E8-4A72-B270-BE7D0A446C65@druware.com>
References: <alpine.DEB.2.02.1305011144590.25330@localhost6.localdomain6>
<518143D3.8060007@commandprompt.com>
<25988.1367430763@sss.pgh.pa.us>
<C27F1394-77E8-4A72-B270-BE7D0A446C65@druware.com>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
On 05/02/2013 01:56 AM, Andrew Satori wrote:
> I would second Tom on this, and if ePub is really a longer term goal of the documentation, the various eBook formats have differing levels of support for hyperlinking that would merit retaining everything in a single book that can be linked from direct references.
I also think we'd be trying to solve an issue that'll solve it self as
ereaders get smarter and faster anyway. eReader performance is growing
much, much faster than the Pg docs. A split of the existing docs along
chapter lines might be worth it for such devices if it's quick and easy,
but otherwise I don't really see the appeal.
I'm a fan of a single big file as well. It improves discoverability of
information because you don't have to find the *correct* manual to read
first, searching is more effective, etc.
As for search: the main thing that needs is a better ebook standard with
pre-built machine-readable keyword indexes, IMO.
--
Craig Ringer http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Training & Services
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
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: craig@2ndquadrant.com, dru@druware.com
Subject: Re: [HACKERS] Documentation epub format
In-Reply-To: <5181EF75.8070208@2ndquadrant.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