public inbox for [email protected]help / color / mirror / Atom feed
how do I suggest a small docs change? 4+ messages / 3 participants [nested] [flat]
* how do I suggest a small docs change? @ 2015-01-24 20:46 J Connolly <[email protected]> 2015-01-25 16:28 ` Re: how do I suggest a small docs change? David G Johnston <[email protected]> 0 siblings, 1 reply; 4+ messages in thread From: J Connolly @ 2015-01-24 20:46 UTC (permalink / raw) To: pgsql-docs 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. 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. Thanks! J Jay Connolly, founder LiftHero.com o: (866) 486-2917 m: (310) 430-0717 Follow <http://www.twitter.com/Lift_Hero; | Connect <http://www.linkedin.com/in/connollyjay; ^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: how do I suggest a small docs change? 2015-01-24 20:46 how do I suggest a small docs change? J Connolly <[email protected]> @ 2015-01-25 16:28 ` David G Johnston <[email protected]> 2015-01-25 17:00 ` Re: how do I suggest a small docs change? J Connolly <[email protected]> 0 siblings, 1 reply; 4+ messages in thread From: David G Johnston @ 2015-01-25 16:28 UTC (permalink / raw) To: pgsql-docs 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 ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs ^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: how do I suggest a small docs change? 2015-01-24 20:46 how do I suggest a small docs change? J Connolly <[email protected]> 2015-01-25 16:28 ` Re: how do I suggest a small docs change? David G Johnston <[email protected]> @ 2015-01-25 17:00 ` J Connolly <[email protected]> 2015-01-26 16:11 ` Re: how do I suggest a small docs change? Kevin Grittner <[email protected]> 0 siblings, 1 reply; 4+ messages in thread From: J Connolly @ 2015-01-25 17:00 UTC (permalink / raw) To: David G Johnston <[email protected]>; +Cc: pgsql-docs 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" <[email protected]> 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 ([email protected]) > To make changes to your subscription: > http://www.postgresql.org/mailpref/pgsql-docs > ^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: how do I suggest a small docs change? 2015-01-24 20:46 how do I suggest a small docs change? J Connolly <[email protected]> 2015-01-25 16:28 ` Re: how do I suggest a small docs change? David G Johnston <[email protected]> 2015-01-25 17:00 ` Re: how do I suggest a small docs change? J Connolly <[email protected]> @ 2015-01-26 16:11 ` Kevin Grittner <[email protected]> 0 siblings, 0 replies; 4+ messages in thread From: Kevin Grittner @ 2015-01-26 16:11 UTC (permalink / raw) To: J Connolly <[email protected]>; David G Johnston <[email protected]>; +Cc: pgsql-docs J Connolly <[email protected]> wrote: > I still think being on github would lower the barrier to entry > for would-be contributors I'm not sure whether you're unaware of the github mirror or want something different: https://github.com/postgres/postgres -- Kevin Grittner EDB: http://www.enterprisedb.com The Enterprise PostgreSQL Company -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs ^ permalink raw reply [nested|flat] 4+ messages in thread
end of thread, other threads:[~2015-01-26 16:11 UTC | newest] Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed) -- links below jump to the message on this page -- 2015-01-24 20:46 how do I suggest a small docs change? J Connolly <[email protected]> 2015-01-25 16:28 ` David G Johnston <[email protected]> 2015-01-25 17:00 ` J Connolly <[email protected]> 2015-01-26 16:11 ` Kevin Grittner <[email protected]>
This inbox is served by agora; see mirroring instructions for how to clone and mirror all data and code used for this inbox