Re: DocBook 5.2 - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: DocBook 5.2
Date
Msg-id YzJfBb+79/gW0d5y@momjian.us
Whole thread Raw
In response to Re: DocBook 5.2  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
On Mon, Sep 26, 2022 at 05:42:32PM -0400, Tom Lane wrote:
> 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.)

+1

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Indecision is a decision.  Inaction is an action.  Mark Batterson




pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: pg_dump: regular expression notation for tables
Next
From: Jürgen Purtz
Date:
Subject: Re: DocBook 5.2