From ca57f0538b6a7413a8ab3fd567b9ece8300eec86 Mon Sep 17 00:00:00 2001 From: Rich Trott Date: Thu, 8 Mar 2018 15:33:10 -0800 Subject: [PATCH 1/2] doc: remove superfluous adverb from style guide --- doc/STYLE_GUIDE.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/doc/STYLE_GUIDE.md b/doc/STYLE_GUIDE.md index 7fc2d6e0b1bb13..2d9c20f666e95d 100644 --- a/doc/STYLE_GUIDE.md +++ b/doc/STYLE_GUIDE.md @@ -13,8 +13,7 @@ * 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"). +* 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: From 17da73521d6e5ed34c366ecf17802adecb030a3d Mon Sep 17 00:00:00 2001 From: Rich Trott Date: Thu, 8 Mar 2018 15:34:14 -0800 Subject: [PATCH 2/2] doc: remove confusing "cats" from style guide --- doc/STYLE_GUIDE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/STYLE_GUIDE.md b/doc/STYLE_GUIDE.md index 2d9c20f666e95d..7da30743cf8929 100644 --- a/doc/STYLE_GUIDE.md +++ b/doc/STYLE_GUIDE.md @@ -17,7 +17,7 @@ * 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" + * OK: "they", "their", "them", "folks", "people", "developers" * NOT OK: "his", "hers", "him", "her", "guys", "dudes" * When combining wrapping elements (parentheses and quotes), terminal punctuation should be placed: