From: Euler Taveira <euler@eulerto.com>
To: rir <rirans@comcast.net>
To: Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: conventions
Date: Wed, 07 Jul 2021 16:13:59 -0300
Message-ID: <614588d6-77cd-4231-8da4-9ba87130e1aa@www.fastmail.com> (raw)
In-Reply-To: <20210707163009.44wpfn7uc72zwyp7@localhost>
References: <20210707163009.44wpfn7uc72zwyp7@localhost>
On Wed, Jul 7, 2021, at 1:30 PM, rir wrote:
>
> The conventions page is weak. Here is a proposed start for
> change. Seeing SQL as an early language, I have tried to use something
> like plain English. Here "early" could describe a mail merge user
> wandering into programming SQL after seeing some simple examples.
Hi Rob,
Unless someone translates your suggestion into a patch, you could probably do
it and submit a patch. If you are a first time contributor, I suggest that you
read Submitting a patch [1]. It is a detailed document that describes the
development workflow.
Talking about this patch, edit doc/src/sgml/notation.sgml, run configure
script, follow the steps described in Building the Documentation section [2]
and send a 'git diff' to this list. You might need some tools [3] to build the
documentation.
[1] https://wiki.postgresql.org/wiki/Submitting_a_Patch
[2] https://www.postgresql.org/docs/current/docguide-build.html
[3] https://www.postgresql.org/docs/current/docguide-toolsets.html
--
Euler Taveira
EDB https://www.enterprisedb.com/
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: euler@eulerto.com, rirans@comcast.net, pgsql-docs@lists.postgresql.org
Subject: Re: conventions
In-Reply-To: <614588d6-77cd-4231-8da4-9ba87130e1aa@www.fastmail.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox