From: | Craig Ringer <craig(at)2ndquadrant(dot)com> |
---|---|
To: | Andrew Satori <dru(at)druware(dot)com> |
Cc: | PostgreSQL Developers <pgsql-docs(at)postgresql(dot)org> |
Subject: | Re: [HACKERS] Documentation epub format |
Date: | 2013-05-02 04:45:41 |
Message-ID: | 5181EF75.8070208@2ndquadrant.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs pgsql-hackers |
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
From | Date | Subject | |
---|---|---|---|
Next Message | Andrew Dunstan | 2013-05-02 07:42:33 | Re: Documentation epub format |
Previous Message | Gavin Flower | 2013-05-02 03:36:57 | Re: Documentation epub format |
From | Date | Subject | |
---|---|---|---|
Next Message | Michael Paquier | 2013-05-02 04:53:53 | Re: Recovery target 'immediate' |
Previous Message | Michael Paquier | 2013-05-02 04:36:42 | \watch stuck on execution of commands returning no tuples |