Skip to content

Commit 32b062e

Browse files
committed
doc: remove personal pronoun guidance
In order to facilitate a more formal voice, the style guide recommends avoiding personal pronouns. In practice, this results in lots of nits for our docs without actually improving them. There are lots of ways our docs can be improved. Making them more formal seems low value, especially for all the PR comments this guidance generates. So, remove that guidance from the style guide.
1 parent 78a7536 commit 32b062e

File tree

1 file changed

+3
-7
lines changed

1 file changed

+3
-7
lines changed

doc/STYLE_GUIDE.md

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,9 @@
1313
* American English spelling is preferred. "Capitalize" vs. "Capitalise",
1414
"color" vs. "colour", etc.
1515
* Use [serial commas][].
16-
* Generally avoid personal pronouns in reference documentation ("I", "you",
17-
"we").
18-
* Pronouns are acceptable in more colloquial documentation, like guides.
19-
* Use gender-neutral pronouns and mass nouns. Non-comprehensive
20-
examples:
21-
* OK: "they", "their", "them", "folks", "people", "developers", "cats"
22-
* NOT OK: "his", "hers", "him", "her", "guys", "dudes"
16+
* Use gender-neutral pronouns and mass nouns. Non-comprehensive examples:
17+
* OK: "they", "their", "them", "folks", "people", "developers", "cats"
18+
* NOT OK: "his", "hers", "him", "her", "guys", "dudes"
2319
* When combining wrapping elements (parentheses and quotes), terminal
2420
punctuation should be placed:
2521
* Inside the wrapping element if the wrapping element contains a complete

0 commit comments

Comments
 (0)