From d2b2baf2a5d61c3ce8a5be1e4eac5f4cf984efce Mon Sep 17 00:00:00 2001 From: Rich Trott Date: Tue, 28 Nov 2017 21:37:55 -0500 Subject: [PATCH] doc: be concise about serial commas MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 Reviewed-By: Alexey Orlenko Reviewed-By: Refael Ackermann Reviewed-By: Myles Borins Reviewed-By: Luigi Pinca Reviewed-By: Daniel Bevenius Reviewed-By: Gibson Fahnestock Reviewed-By: Colin Ihrig Reviewed-By: Jon Moss Reviewed-By: Michael Dawson Reviewed-By: Richard Lau Reviewed-By: Tobias Nießen --- doc/STYLE_GUIDE.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/STYLE_GUIDE.md b/doc/STYLE_GUIDE.md index 9cdbf0d7b63631..d1bf5208595c20 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