agora inbox for pgsql-docs@postgresql.org  

help / color / mirror / Atom feed

From: Tom Lane <tgl@sss.pgh.pa.us>
To: Bruce Momjian <bruce@momjian.us>
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: Jürgen Purtz <juergen@purtz.de>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: DocBook 5.2
Date: Mon, 26 Sep 2022 17:42:32 -0400
Message-ID: <3524032.1664228552@sss.pgh.pa.us> (raw)
In-Reply-To: <YzIY/OCgljTdqOgX@momjian.us>
References: <ae14eca5-f57c-2db2-42ce-258bab3c6806@purtz.de>
	<20220905111508.wzgmpbcarxizdnin@alvherre.pgsql>
	<YzIY/OCgljTdqOgX@momjian.us>

Bruce Momjian <bruce@momjian.us> writes:
> On Mon, Sep  5, 2022 at 01:15:08PM +0200, Álvaro Herrera wrote:
>> OK, these seem quite significant changes that are likely to cause great
>> pain.  So I repeat my question, what are the benefits of making this
>> change?  They better be very very substantial.

> Would we be converting docs for all supported versions of Postgres to
> use DocBook 5.2, or just the most current version?  If the later, we
> would find backpatching a pain for five years.

Yeah, I think we'd have to convert all the supported versions to
make this palatable.  If the conversion is sufficiently automated,
that might not be a big lift.  (If it's *not* automated, I think
the change would never get off the ground even for HEAD, because
the docs are too much of a moving target.)

			regards, tom lane

view thread (19+ messages)  latest in thread

Message-ID: <3524032.1664228552@sss.pgh.pa.us>
Permalink:  ../3524032.1664228552@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/3524032.1664228552@sss.pgh.pa.us

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: tgl@sss.pgh.pa.us, bruce@momjian.us, alvherre@alvh.no-ip.org, juergen@purtz.de, pgsql-docs@lists.postgresql.org
  Subject: Re: DocBook 5.2
  In-Reply-To: <3524032.1664228552@sss.pgh.pa.us>

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

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