Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from ) id 1YFQYK-0002R1-9C for pgsql-docs@arkaria.postgresql.org; Sun, 25 Jan 2015 17:00:48 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.80) (envelope-from ) id 1YFQYJ-0002rT-D8 for pgsql-docs@arkaria.postgresql.org; Sun, 25 Jan 2015 17:00:47 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.2:DHE_RSA_AES_256_CBC_SHA256:256) (Exim 4.80) (envelope-from ) id 1YFQYI-0002rN-PP for pgsql-docs@postgresql.org; Sun, 25 Jan 2015 17:00:46 +0000 Received: from mail-ie0-x22a.google.com ([2607:f8b0:4001:c03::22a]) by magus.postgresql.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.80) (envelope-from ) id 1YFQYD-0003Ve-Fb for pgsql-docs@postgresql.org; Sun, 25 Jan 2015 17:00:45 +0000 Received: by mail-ie0-f170.google.com with SMTP id y20so5107237ier.1 for ; Sun, 25 Jan 2015 09:00:38 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date:message-id:subject :from:to:cc:content-type; bh=B3sOALduCmOy56GmGd/vukQK64JM138eRfHRhXJq2EQ=; b=cdAku0wbE4al5PIDqWANBV3sA5sXhtHVNyic4E1zyJYF/BJaMJwabeAEdD2Obp545u SihptynbVIMw7tA6kcaC3zhCYayACCdeSb8tlCm8G9qK1ruCK6dionOfv5AiVHwc/Rad OJBePuFAGOSeCXi7jNjTfzCfslnFOvUH02lZwYR3tdrvoZ+wQ8OlPnvedBX9HaDpdE6Z 6jyTgondZaYapb9I5OBtTsAeMIoe6+PC2nus3GelhepBst9wt3+21RWEtHhj/DIkJQWJ k7LnWmnMlJ0hdOtuF2H80Pq2brn3aXrtXIxqDX3C1hdSFjjzUj43b9kWnKy9zWQsGzOg szaA== MIME-Version: 1.0 X-Received: by 10.43.126.67 with SMTP id gv3mr17929283icc.31.1422205238618; Sun, 25 Jan 2015 09:00:38 -0800 (PST) Received: by 10.36.53.129 with HTTP; Sun, 25 Jan 2015 09:00:38 -0800 (PST) Received: by 10.36.53.129 with HTTP; Sun, 25 Jan 2015 09:00:38 -0800 (PST) In-Reply-To: <1422203336861-5835372.post@n5.nabble.com> References: <1422203336861-5835372.post@n5.nabble.com> Date: Sun, 25 Jan 2015 09:00:38 -0800 X-Google-Sender-Auth: 70rSwPu_B-M-uOOJqJtzTha0ayA Message-ID: Subject: Re: how do I suggest a small docs change? From: J Connolly To: David G Johnston Cc: pgsql-docs@postgresql.org Content-Type: multipart/alternative; boundary=bcaec51824a80bb0b5050d7cf694 X-Pg-Spam-Score: -2.4 (--) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-docs Precedence: bulk Sender: pgsql-docs-owner@postgresql.org --bcaec51824a80bb0b5050d7cf694 Content-Type: text/plain; charset=UTF-8 Thanks for the reply, David! I still think being on github would lower the barrier to entry for would-be contributors, independent of the SGML format. Whether you want to encourage more suggestions from less invested people like me, including some that clearly conflict with established convention, is another issue :). J typed with thumbs from (310) 430-0717 On Jan 25, 2015 8:29 AM, "David G Johnston" wrote: > J Connolly wrote > > Hi, just wondering how to suggest a small change to the docs. On a > related > > note, if the source was on github it would be easier for people like me > to > > suggest a change. > > Just post your thoughts to -docs. The harder part of doc changes is SGML, > not the fact the Git repo is not on GitHub. > > > > Here's the suggested change: > > The tutorial at ( > > http://www.postgresql.org/docs/9.4/static/tutorial-transactions.html) > > should use integers (i.e. cents) when dealing with currency. Tangential > to > > the point of that page, but important given that it's a page targeted at > > beginners. > > That example uses the numeric type for currency; which is considerably less > convoluted then forcing everything to have hundredths resolution and > multiplication if you want to show the nominal unit (e.g. dollars). > > David J. > > > > > -- > View this message in context: > http://postgresql.nabble.com/how-do-I-suggest-a-small-docs-change-tp5835330p5835372.html > Sent from the PostgreSQL - docs mailing list archive at Nabble.com. > > > -- > Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) > To make changes to your subscription: > http://www.postgresql.org/mailpref/pgsql-docs > --bcaec51824a80bb0b5050d7cf694 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable

Thanks for the reply, David! I still think being on github w= ould lower the barrier to entry for would-be contributors, independent of t= he SGML format. Whether you want to encourage more suggestions from less in= vested people like me, including some that clearly conflict with establishe= d convention, is another issue :).

J

typed with thumbs from (310) 430-0717

On Jan 25, 2015 8:29 AM, "David G Johnston&= quot; <david.g.johnston@gm= ail.com> wrote:
J Connolly wrote
> Hi, just wondering how to suggest a small change to the docs. On a rel= ated
> note, if the source was on github it would be easier for people like m= e to
> suggest a change.

Just post your thoughts to -docs.=C2=A0 The harder part of doc changes is S= GML,
not the fact the Git repo is not on GitHub.


> Here's the suggested change:
> The tutorial at (
> http://www.postgresql.org/docs/9.4/static/tuto= rial-transactions.html)
> should use integers (i.e. cents) when dealing with currency. Tangentia= l to
> the point of that page, but important given that it's a page targe= ted at
> beginners.

That example uses the numeric type for currency; which is considerably less=
convoluted then forcing everything to have hundredths resolution and
multiplication if you want to show the nominal unit (e.g. dollars).

David J.




--
View this message in context: h= ttp://postgresql.nabble.com/how-do-I-suggest-a-small-docs-change-tp5835330p= 5835372.html
Sent from the PostgreSQL - docs mailing list archive at Nabble.com.


--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
--bcaec51824a80bb0b5050d7cf694--