From 32b062e2c772d76a84f09dc1ac0a06976eef14a4 Mon Sep 17 00:00:00 2001 From: Rich Trott Date: Tue, 6 Mar 2018 15:11:03 -0800 Subject: [PATCH] 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. --- doc/STYLE_GUIDE.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/doc/STYLE_GUIDE.md b/doc/STYLE_GUIDE.md index 7fc2d6e0b1bb13..015ef2be46a282 100644 --- a/doc/STYLE_GUIDE.md +++ b/doc/STYLE_GUIDE.md @@ -13,13 +13,9 @@ * American English spelling is preferred. "Capitalize" vs. "Capitalise", "color" vs. "colour", etc. * Use [serial commas][]. -* Generally avoid personal pronouns in reference documentation ("I", "you", - "we"). - * Pronouns are acceptable in more colloquial documentation, like guides. - * Use gender-neutral pronouns and mass nouns. Non-comprehensive - examples: - * OK: "they", "their", "them", "folks", "people", "developers", "cats" - * NOT OK: "his", "hers", "him", "her", "guys", "dudes" +* Use gender-neutral pronouns and mass nouns. Non-comprehensive examples: + * OK: "they", "their", "them", "folks", "people", "developers", "cats" + * NOT OK: "his", "hers", "him", "her", "guys", "dudes" * When combining wrapping elements (parentheses and quotes), terminal punctuation should be placed: * Inside the wrapping element if the wrapping element contains a complete