diff options
author | Rich Trott <rtrott@gmail.com> | 2017-11-29 05:37:55 +0300 |
---|---|---|
committer | Rich Trott <rtrott@gmail.com> | 2017-12-02 01:46:08 +0300 |
commit | d2b2baf2a5d61c3ce8a5be1e4eac5f4cf984efce (patch) | |
tree | 833e534e9942cbdcd47ec138f3a70db518287d5e /doc/STYLE_GUIDE.md | |
parent | 845633a7c62ad9ffd33880a43e05a49382bb76bb (diff) |
doc: be concise about serial commas
There is no need to hedge bets on the serial comma. Simply instruct
people to use it.
PR-URL: https://github.com/nodejs/node/pull/17384
Reviewed-By: Timothy Gu <timothygu99@gmail.com>
Reviewed-By: Alexey Orlenko <eaglexrlnk@gmail.com>
Reviewed-By: Refael Ackermann <refack@gmail.com>
Reviewed-By: Myles Borins <myles.borins@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Daniel Bevenius <daniel.bevenius@gmail.com>
Reviewed-By: Gibson Fahnestock <gibfahn@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Jon Moss <me@jonathanmoss.me>
Reviewed-By: Michael Dawson <michael_dawson@ca.ibm.com>
Reviewed-By: Richard Lau <riclau@uk.ibm.com>
Reviewed-By: Tobias Nießen <tniessen@tnie.de>
Diffstat (limited to 'doc/STYLE_GUIDE.md')
-rw-r--r-- | doc/STYLE_GUIDE.md | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/doc/STYLE_GUIDE.md b/doc/STYLE_GUIDE.md index 9cdbf0d7b63..d1bf5208595 100644 --- a/doc/STYLE_GUIDE.md +++ b/doc/STYLE_GUIDE.md @@ -14,7 +14,7 @@ human reviewers. * American English spelling is preferred. "Capitalize" vs. "Capitalise", "color" vs. "colour", etc. -* Though controversial, the [Oxford comma][] is preferred for clarity's sake. +* Use [serial commas][]. * Generally avoid personal pronouns in reference documentation ("I", "you", "we"). * Pronouns are acceptable in more colloquial documentation, like guides. @@ -75,6 +75,6 @@ [Em dashes]: https://en.wikipedia.org/wiki/Dash#Em_dash [Javascript type]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Grammar_and_types#Data_structures_and_types -[Oxford comma]: https://en.wikipedia.org/wiki/Serial_comma +[serial commas]: https://en.wikipedia.org/wiki/Serial_comma [The New York Times Manual of Style and Usage]: https://en.wikipedia.org/wiki/The_New_York_Times_Manual_of_Style_and_Usage [plugin]: http://editorconfig.org/#download |