Skip to content

Commit aa45aa4

Browse files
Trottgibfahn
authored andcommitted
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 <[email protected]> Reviewed-By: Alexey Orlenko <[email protected]> Reviewed-By: Refael Ackermann <[email protected]> Reviewed-By: Myles Borins <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Daniel Bevenius <[email protected]> Reviewed-By: Gibson Fahnestock <[email protected]> Reviewed-By: Colin Ihrig <[email protected]> Reviewed-By: Jon Moss <[email protected]> Reviewed-By: Michael Dawson <[email protected]> Reviewed-By: Richard Lau <[email protected]> Reviewed-By: Tobias Nießen <[email protected]>
1 parent d00df5d commit aa45aa4

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

doc/STYLE_GUIDE.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
human reviewers.
1515
* American English spelling is preferred. "Capitalize" vs. "Capitalise",
1616
"color" vs. "colour", etc.
17-
* Though controversial, the [Oxford comma][] is preferred for clarity's sake.
17+
* Use [serial commas][].
1818
* Generally avoid personal pronouns in reference documentation ("I", "you",
1919
"we").
2020
* Pronouns are acceptable in more colloquial documentation, like guides.
@@ -72,6 +72,6 @@
7272

7373
[Em dashes]: https://en.wikipedia.org/wiki/Dash#Em_dash
7474
[Javascript type]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Grammar_and_types#Data_structures_and_types
75-
[Oxford comma]: https://en.wikipedia.org/wiki/Serial_comma
75+
[serial commas]: https://en.wikipedia.org/wiki/Serial_comma
7676
[The New York Times Manual of Style and Usage]: https://en.wikipedia.org/wiki/The_New_York_Times_Manual_of_Style_and_Usage
7777
[plugin]: http://editorconfig.org/#download

0 commit comments

Comments
 (0)