Re: Documentation epub format

From: Josh Berkus <josh(at)agliodbs(dot)com>
To: pgsql-hackers(at)postgresql(dot)org
Subject: Re: Documentation epub format
Date: 2013-05-01 19:25:18
Message-ID: 51816C1E.3010009@agliodbs.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On 05/01/2013 10:52 AM, Tom Lane wrote:
> "Joshua D. Drake" <jd(at)commandprompt(dot)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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Josh Berkus 2013-05-01 19:28:19 Re: Documentation epub format
Previous Message Ross Reedstrom 2013-05-01 18:33:45 Re: Documentation epub format

Browse pgsql-hackers by date

  From Date Subject
Next Message Josh Berkus 2013-05-01 19:28:19 Re: Documentation epub format
Previous Message Simon Riggs 2013-05-01 19:06:22 Re: corrupt pages detected by enabling checksums