Message-ID: <51816C1E.3010009@agliodbs.com>
Date: Wed, 01 May 2013 12:25:18 -0700
From: Josh Berkus <josh@agliodbs.com>
Organization: PostgreSQL Experts Inc.
User-Agent: Mozilla/5.0 (X11; Linux x86_64;
	rv:17.0) Gecko/20130329 Thunderbird/17.0.5
MIME-Version: 1.0
To: pgsql-hackers@postgresql.org
Subject: Re: Documentation epub format
References: <alpine.DEB.2.02.1305011144590.25330@localhost6.localdomain6>
	<518143D3.8060007@commandprompt.com>
	<25988.1367430763@sss.pgh.pa.us>
	<WM!010260633e7a7e647748e65bedcdb77a2196bb03f0b34a952ad0fbe729d94bcd66adf9b5d7104aaee2d5cd72e0620dd5!@asav-1.01.com>
In-Reply-To: 
 <WM!010260633e7a7e647748e65bedcdb77a2196bb03f0b34a952ad0fbe729d94bcd66adf9b5d7104aaee2d5cd72e0620dd5!@asav-1.01.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Precedence: bulk
Sender: pgsql-hackers-owner@postgresql.org

On 05/01/2013 10:52 AM, Tom Lane wrote:
> "Joshua D. Drake" <jd@commandprompt.com> writes:
>> 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.
> 
> The reason we merged them was to allow hyperlink cross-references between
> different parts of the docs.  I would be sad to lose that.

Also the divisions between sections were totally arbitrary and unintuitive.

I think it would make a lot more sense to modify the SGML export to
create a book per chapter.


-- 
Josh Berkus
PostgreSQL Experts Inc.
http://pgexperts.com


-- 
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers