Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1UXZyP-0000xR-8N for pgsql-hackers@arkaria.postgresql.org; Wed, 01 May 2013 16:33:41 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.72) (envelope-from ) id 1UXZyO-0001mq-PP for pgsql-hackers@arkaria.postgresql.org; Wed, 01 May 2013 16:33:40 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1UXZyN-0001mk-R2 for pgsql-hackers@postgresql.org; Wed, 01 May 2013 16:33:39 +0000 Received: from 30.55.colo.spiretech.net ([69.168.55.30] helo=lists.commandprompt.com) by magus.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1UXZyI-0006pz-MG for pgsql-hackers@postgresql.org; Wed, 01 May 2013 16:33:38 +0000 Received: from [192.168.1.5] (spinlock.commandprompt.com [69.168.55.30]) by lists.commandprompt.com (Postfix) with ESMTPA id C164F28B; Wed, 1 May 2013 09:33:31 -0700 (PDT) Received: from [192.168.1.5] ([71.95.101.172] helo=[192.168.1.5]) by assp.commandprompt.com with ESMTPS(AES256-SHA) (2.1.1); 1 May 2013 09:33:31 -0700 Message-ID: <518143D3.8060007@commandprompt.com> Date: Wed, 01 May 2013 09:33:23 -0700 From: "Joshua D. Drake" Organization: Command Prompt, Inc. User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130404 Thunderbird/17.0.5 MIME-Version: 1.0 To: Fabien COELHO CC: PostgreSQL Developers Subject: Re: Documentation epub format References: In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Assp-Version: 2.1.1(11364) on assp.commandprompt.com X-Assp-Client-SSL: yes X-Assp-ID: assp.commandprompt.com m1-26011-12801 X-Assp-Envelope-From: jd@commandprompt.com X-Assp-Intended-For: coelho@cri.ensmp.fr X-Assp-Original-Subject: Re: [HACKERS] Documentation epub format X-Pg-Spam-Score: -1.9 (-) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-hackers Precedence: bulk Sender: pgsql-hackers-owner@postgresql.org 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