Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1UXlPJ-0004QW-8y for pgsql-docs@arkaria.postgresql.org; Thu, 02 May 2013 04:46:13 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.72) (envelope-from ) id 1UXlPI-0003vb-Os for pgsql-docs@arkaria.postgresql.org; Thu, 02 May 2013 04:46:12 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1UXlPH-0003vV-Vr for pgsql-docs@postgresql.org; Thu, 02 May 2013 04:46:12 +0000 Received: from outmail148102.authsmtp.net ([62.13.148.102]) by magus.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1UXlPE-0005xa-9J for pgsql-docs@postgresql.org; Thu, 02 May 2013 04:46:11 +0000 Received: from mail-c233.authsmtp.com (mail-c233.authsmtp.com [62.13.128.233]) by punt7.authsmtp.com (8.14.2/8.14.2/Kp) with ESMTP id r424jnw5079179; Thu, 2 May 2013 05:45:49 +0100 (BST) Received: from ayaki.localdomain (58-7-164-143.dyn.iinet.net.au [58.7.164.143]) (authenticated bits=0) by mail.authsmtp.com (8.14.2/8.14.2/) with ESMTP id r424jgnc007175 (version=TLSv1/SSLv3 cipher=DHE-RSA-CAMELLIA256-SHA bits=256 verify=NO); Thu, 2 May 2013 05:45:46 +0100 (BST) Message-ID: <5181EF75.8070208@2ndquadrant.com> Date: Thu, 02 May 2013 12:45:41 +0800 From: Craig Ringer Organization: 2nd Quadrant User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130311 Thunderbird/17.0.4 MIME-Version: 1.0 To: Andrew Satori CC: PostgreSQL Developers Subject: Re: [HACKERS] Documentation epub format References: <518143D3.8060007@commandprompt.com> <25988.1367430763@sss.pgh.pa.us> In-Reply-To: X-Enigmail-Version: 1.5.1 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-Server-Quench: 2826c7c5-b2e3-11e2-a49c-0025907707a1 X-AuthReport-Spam: If SPAM / abuse - report it at: http://www.authsmtp.com/abuse X-AuthRoute: OCdxZQATClZeVg0b BQteCiNZVAwpPBRK HVkIKg5MJUcNSQVJ NksadBtFaAdbYFhI HGQLWldEUFh7XWZ/ bw0faA1DZVRPWQF0 UUxKXVBXFgB3AFJD AhwaCE4sJAVGf393 YAhnW3FfEkZyd0Au RR1RCD8EMGR9aWFK Ul0JcwoHbQNKfBpM ald4VHRcYCtlM3Bw LC8aFBMcBw5qYAhS SRwIIFQOSFoKGTh0 SggfF30hGlcATjlb X-Authentic-SMTP: 61633235383639.1021:706 X-AuthFastPath: 0 (Was 255) X-AuthSMTP-Origin: 58.7.164.143/2525 X-AuthVirus-Status: No virus detected - but ensure you scan with your own anti-virus system. X-Pg-Spam-Score: -2.6 (--) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-docs Precedence: bulk Sender: pgsql-docs-owner@postgresql.org 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