Skip to content

Commit 9df52dd

Browse files
TrottMylesBorins
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 4fb0708 commit 9df52dd

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

doc/STYLE_GUIDE.md

+2-2
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.
@@ -75,6 +75,6 @@
7575

7676
[Em dashes]: https://en.wikipedia.org/wiki/Dash#Em_dash
7777
[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
7979
[The New York Times Manual of Style and Usage]: https://en.wikipedia.org/wiki/The_New_York_Times_Manual_of_Style_and_Usage
8080
[plugin]: http://editorconfig.org/#download

0 commit comments

Comments
 (0)