Commit 9df52dd
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: #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>1 parent 4fb0708 commit 9df52dd
1 file changed
Lines changed: 2 additions & 2 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -14,7 +14,7 @@ | |||
| 14 | 14 | human reviewers. | |
| 15 | 15 | * American English spelling is preferred. "Capitalize" vs. "Capitalise", | |
| 16 | 16 | "color" vs. "colour", etc. | |
| 17 | - * Though controversial, the [Oxford comma][] is preferred for clarity's sake. | ||
| 17 | + * Use [serial commas][]. | ||
| 18 | 18 | * Generally avoid personal pronouns in reference documentation ("I", "you", | |
| 19 | 19 | "we"). | |
| 20 | 20 | * Pronouns are acceptable in more colloquial documentation, like guides. | |
@@ -75,6 +75,6 @@ | |||
| 75 | 75 | ||
| 76 | 76 | [Em dashes]: https://en.wikipedia.org/wiki/Dash#Em_dash | |
| 77 | 77 | [Javascript type]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Grammar_and_types#Data_structures_and_types | |
| 78 | - [Oxford comma]: https://en.wikipedia.org/wiki/Serial_comma | ||
| 78 | + [serial commas]: https://en.wikipedia.org/wiki/Serial_comma | ||
| 79 | 79 | [The New York Times Manual of Style and Usage]: https://en.wikipedia.org/wiki/The_New_York_Times_Manual_of_Style_and_Usage | |
| 80 | 80 | [plugin]: http://editorconfig.org/#download | |
0 commit comments