Re: Documentation epub format - Mailing list pgsql-hackers

From Josh Berkus
Subject Re: Documentation epub format
Date
Msg-id 51816C1E.3010009@agliodbs.com
Whole thread Raw
In response to Documentation epub format  (Fabien COELHO <coelho@cri.ensmp.fr>)
List pgsql-hackers
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



pgsql-hackers by date:

Previous
From: Simon Riggs
Date:
Subject: Re: corrupt pages detected by enabling checksums
Next
From: Josh Berkus
Date:
Subject: Re: Documentation epub format