GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — doc: relax prohibition on personal pronouns · nodejs/node@d195d20

File tree

Expand file treeCollapse file tree
Open diff view settings
Filter options
  • doc/guides
    • doc-style-guide.md
Expand file treeCollapse file tree
Open diff view settings
Collapse file

‎doc/guides/doc-style-guide.md‎

Copy file name to clipboardExpand all lines: doc/guides/doc-style-guide.md
+5-5Lines changed: 5 additions & 5 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,11 @@ this guide.
1919
* Check changes to documentation with `make lint-md`.
2020
* [Use US spelling][].
2121
* [Use serial commas][].
22-
* Avoid personal pronouns (_I_, _you_, _we_) in reference documentation.
23-
* Personal pronouns are acceptable in colloquial documentation such as guides.
24-
* Use gender-neutral pronouns and gender-neutral plural nouns.
25-
* OK: _they_, _their_, _them_, _folks_, _people_, _developers_
26-
* NOT OK: _his_, _hers_, _him_, _her_, _guys_, _dudes_
22+
* Avoid first-person pronouns (_I_, _we_).
23+
* Exception: _we recommend foo_ is preferable to _foo is recommended_.
24+
* Use gender-neutral pronouns and gender-neutral plural nouns.
25+
* OK: _they_, _their_, _them_, _folks_, _people_, _developers_
26+
* NOT OK: _his_, _hers_, _him_, _her_, _guys_, _dudes_
2727
* When combining wrapping elements (parentheses and quotes), place terminal
2828
punctuation:
2929
* Inside the wrapping element if the wrapping element contains a complete

0 commit comments

Comments
0 (0)
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.