Commit 363761e6cfa for woocommerce
commit 363761e6cfaac9d9d703e077192b640a5f8cfa02
Author: Brent MacKinnon <brent.mackinnon@a8c.com>
Date: Thu Aug 13 08:47:26 2026 -0400
Update grammar-punctuation-capitalization.md (#47679)
diff --git a/docs/best-practices/coding-standards/grammar-punctuation-capitalization.md b/docs/best-practices/coding-standards/grammar-punctuation-capitalization.md
index b1883dc9513..ad29d02a110 100644
--- a/docs/best-practices/coding-standards/grammar-punctuation-capitalization.md
+++ b/docs/best-practices/coding-standards/grammar-punctuation-capitalization.md
@@ -279,7 +279,9 @@ Capitalize job titles, the names of teams, and departments.
#### Pronouns
-Use he/him/his and she/her/her as appropriate. Don't use "one" as a pronoun. Use they/them/their if gender is unknown or when referring to a group.
+Use personal pronouns such as he/him/his, she/her/hers, and they/them/theirs as appropriate when referring to a specific person. When talking abstractly (rather than about a specific person), default to they/them/theirs, not he/him/his. For example: "when a developer needs to troubleshoot, they might choose to use Xdebug".
+
+Don't use "one" as a pronoun. Instead, use "you" when talking directly to the reader. For example, use "if you encounter an error, you should try deactivating the plugin" rather than "if one encounters an error, they should try deactivating the plugin".
#### Quotations