pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed
From: Josh Berkus <josh@agliodbs.com>
To: pgsql-hackers@postgresql.org
Subject: Re: Documentation epub format
Date: Wed, 01 May 2013 12:25:18 -0700
Message-ID: <51816C1E.3010009@agliodbs.com> (raw)
In-Reply-To: <WM!010260633e7a7e647748e65bedcdb77a2196bb03f0b34a952ad0fbe729d94bcd66adf9b5d7104aaee2d5cd72e0620dd5!@asav-1.01.com>
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>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-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


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



view thread (29+ messages)  latest in thread

Message-ID: <51816C1E.3010009@agliodbs.com>
Permalink:  ../51816C1E.3010009@agliodbs.com/
Also on:    postgresql.org/message-id/51816C1E.3010009@agliodbs.com

 · 

reply
Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: josh@agliodbs.com, pgsql-hackers@postgresql.org
  Subject: Re: Documentation epub format
  In-Reply-To: <51816C1E.3010009@agliodbs.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox