Re: Fwd: Would like to help with documentation for Postgres 11 - Mailing list pgsql-hackers

From Justin Pryzby
Subject Re: Fwd: Would like to help with documentation for Postgres 11
Date
Msg-id 20180729212719.GD3222@telsasoft.com
Whole thread Raw
In response to Fwd: Would like to help with documentation for Postgres 11  (Michael Goldshteyn <mgold10000@gmail.com>)
Responses Re: Fwd: Would like to help with documentation for Postgres 11  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-hackers
On Sun, Jul 29, 2018 at 11:50:40AM -0500, Michael Goldshteyn wrote:
> I would like to offer some help writing and improving the English
> documentation for some of the new features and changes in Postgres 11. If I
> can get an email of where such help would be appreciated, so I can choose a
> feature I am familiar with, I would be glad to help.

The documentation is expected to be commited with the feature, so what's
currently in place is expected to be adequate and accuate.

You could review any documentation changes since v10.  Any issues or
improvements you can discuss or send patch to -hackers.

Maybe something like:
git log -p REL_10_4..REL_11_BETA2 doc/
..or just git diff which would not show commits separately but also would not
show multiple updates for same feature (like: commit: feature... commit:
improve documentation... commit: fix typos... commit: change default)

Alternately you can look at the pg11 release notes (or git log?) for list of
features and check that corresponding documentation exists and is accurate.
That could conceivably expose implementation bugs, eg. with edge cases.
git log REL_10_4..REL_11_BETA2

Justin


pgsql-hackers by date:

Previous
From: Tomas Vondra
Date:
Subject: Re: [PATCH] Improve geometric types
Next
From: Tom Lane
Date:
Subject: Re: Fwd: Would like to help with documentation for Postgres 11