On 6/6/24 14:12, Tom Lane wrote:
Robert Haas <robertmh...@gmail.com> writes:
On Thu, Jun 6, 2024 at 4:25 AM Hannu Krosing <han...@google.com> wrote:
Not absolutely sure, but would at least adding a page to PostgreSQL
Wiki about this make sense ?
I feel like we need to do something. Tom says this is a policy, and
he's made that comment before about other things, but the fact that
they're not memorialized anywhere is a huge problem, IMHO.
I didn't say it wasn't ;-)
ISTM we have two basic choices: wiki page, or new SGML docs section.
In the short term I'd lean to a wiki page. It'd be reasonable for
https://wiki.postgresql.org/wiki/Committing_checklist
to link to it (and maybe the existing section there about release
freezes would be more apropos on a "Project policies" page? Not
sure.)
To get a sense of how much of a problem we have, I grepped the git
history for comments mentioning project policies. Ignoring ones
that are really talking about very localized issues, what I found
is attached. It seems like it's little enough that a single wiki
page with subsections ought to be enough. I'm not super handy with
editing the wiki, plus I'm only firing on one cylinder today (seem
to have acquired a head cold at pgconf), so maybe somebody else
would like to draft something?
I added them here with minimal copy editing an no attempt to organize or
sort into groups:
https://wiki.postgresql.org/wiki/Committing_checklist#Policies
If someone has thoughts on how to improve I am happy to make more changes.
--
Joe Conway
PostgreSQL Contributors Team
RDS Open Source Databases
Amazon Web Services: https://aws.amazon.com
