Re: Fwd: Would like to help with documentation for Postgres 11

From: Justin Pryzby <pryzby(at)telsasoft(dot)com>
To: Michael Goldshteyn <mgold10000(at)gmail(dot)com>
Cc: pgsql-hackers(at)lists(dot)postgresql(dot)org
Subject: Re: Fwd: Would like to help with documentation for Postgres 11
Date: 2018-07-29 21:27:19
Message-ID: 20180729212719.GD3222@telsasoft.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers 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

In response to

Responses

Browse pgsql-committers by date

  From Date Subject
Next Message Tom Lane 2018-07-29 21:38:54 Re: Fwd: Would like to help with documentation for Postgres 11
Previous Message Tomas Vondra 2018-07-29 21:15:56 pgsql: Mark variable used only in assertion with PG_USED_FOR_ASSERTS_ON

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2018-07-29 21:38:54 Re: Fwd: Would like to help with documentation for Postgres 11
Previous Message Tomas Vondra 2018-07-29 21:16:05 Re: [PATCH] Improve geometric types