Обсуждение: how do I suggest a small docs change?

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

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

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

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

J Connolly <J@lifthero.com> 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