From: Tom Lane <tgl@sss.pgh.pa.us>
To: "Euler Taveira" <euler@eulerto.com>
cc: "Daniel Gustafsson" <daniel@yesql.se>,
        "Marcos Pegoraro" <marcos@f10.com.br>,
        "Alvaro Herrera" <alvherre@alvh.no-ip.org>, pgsql-www@postgresql.org
Subject: Re: Diff of this page with other version
In-reply-to: <aa2c2c74-0502-4866-99f1-6abf49e35e0f@app.fastmail.com>
References: 
 <CAB-JLwYmR+sW9spQQMjnLT0hbAR_3qTCqqJgt-sC3=NgCSJyRg@mail.gmail.com>
 <202403021444.yyabqn4eatpx@alvherre.pgsql>
 <CAB-JLwZL8siWp16qvsoUiADV1eW1z1VW1e9F_UkQnxo5yQ54JQ@mail.gmail.com>
 <EDC52F6C-806F-4E3D-AB6E-F6B567AFB4B9@yesql.se>
 <aa2c2c74-0502-4866-99f1-6abf49e35e0f@app.fastmail.com>
Comments: In-reply-to "Euler Taveira" <euler@eulerto.com>
	message dated "Mon, 04 Mar 2024 11:45:38 -0300"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <3597694.1709565152.1@sss.pgh.pa.us>
Date: Mon, 04 Mar 2024 10:12:32 -0500
Message-ID: <3597695.1709565152@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/3597695.1709565152%40sss.pgh.pa.us>
Precedence: bulk

"Euler Taveira" <euler@eulerto.com> writes:
> There is also tools like pgPedia [1] that provides a command / function
> history. Unless there is a way to automate this request as Alvaro said, it
> would impose extra work by adding tags to mark that a feature adds a keyword
> and/or value. What happen if a deprecated keyword / value was removed? The
> synopsis content can be rearranged too. I have a gut feeling that some work
> should be done manually.

There's no doubt that we could get *better* results with the addition
of manual effort.  But even htmldiff as it stands today produces
*usable* results (I tried it on a couple of versions of the COPY
reference page).  Given that we've not offered something like this
at all before, I think it's silly to put in a lot of up-front effort
in advance of seeing what the demand really is.

In any case, I concur with the other committers that there is simply
no way we're going to accept manual change markup as an additional
expectation for documentation commits.  It's hard enough already.

			regards, tom lane