Skip to content

doc: use better terminology for build machines#17142

Closed
addaleax wants to merge 1 commit intonodejs:masterfrom
addaleax:doc-racism
Closed

doc: use better terminology for build machines#17142
addaleax wants to merge 1 commit intonodejs:masterfrom
addaleax:doc-racism

Conversation

@addaleax
Copy link
Member

@addaleax addaleax commented Nov 19, 2017

R=@nodejs/release

@nodejs-github-bot nodejs-github-bot added the doc Issues and PRs related to the documentations. label Nov 19, 2017
@gireeshpunathil
Copy link
Member

gireeshpunathil commented Nov 20, 2017

I remember reviews that discouraged personal pronouns in documents. While none is introduced newly here, there are a few, please have another look and see if this is something you can workaround, while we are here.

@gibfahn
Copy link
Member

gibfahn commented Nov 20, 2017

While none is introduced newly here, there are a few, please

doc/releases.md is entirely addressed to the releaser, so I'm not sure you is avoidable here. It basically goes through the 100 things a releaser has to do. Changing it would be a pretty substantial rewrite, and probably best done in a separate PR if at all.

As this isn't external documentation, I'm not sure removing you is actually necessary.

@vsemozhetbyt
Copy link
Contributor

vsemozhetbyt commented Nov 20, 2017

FWIW, our STYLE_GUIDE.md notes:

Pronouns are acceptable in more colloquial documentation, like guides.

mhdawson
mhdawson approved these changes Nov 21, 2017
View reviewed changes
Copy link
Member

@mhdawson mhdawson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@mhdawson mhdawson added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Nov 21, 2017
@mhdawson
Copy link
Member

mhdawson commented Nov 21, 2017

CI run: https://ci.nodejs.org/job/node-test-pull-request/11593/

jasnell pushed a commit that referenced this pull request Nov 22, 2017
@addaleax @jasnell
doc: use better terminology for build machines
8f50407 
PR-URL: #17142
Reviewed-By: Vse Mozhet Byt <[email protected]>
Reviewed-By: Gibson Fahnestock <[email protected]>
Reviewed-By: Refael Ackermann <[email protected]>
Reviewed-By: Gireesh Punathil <[email protected]>
Reviewed-By: Anatoli Papirovski <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: Michael Dawson <[email protected]>
@jasnell
Copy link
Member

jasnell commented Nov 22, 2017

Landed in 8f50407

@jasnell jasnell closed this Nov 22, 2017
@Trott
Copy link
Member

Trott commented Nov 23, 2017

There's one more instance in a comment in tools/release.sh if someone wants to fix that one or maybe hand it out as a good first task to someone.

@addaleax addaleax removed the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Nov 28, 2017
MylesBorins pushed a commit that referenced this pull request Dec 12, 2017
@addaleax @MylesBorins
doc: use better terminology for build machines
9528fa1 
PR-URL: #17142
Reviewed-By: Vse Mozhet Byt <[email protected]>
Reviewed-By: Gibson Fahnestock <[email protected]>
Reviewed-By: Refael Ackermann <[email protected]>
Reviewed-By: Gireesh Punathil <[email protected]>
Reviewed-By: Anatoli Papirovski <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: Michael Dawson <[email protected]>
MylesBorins pushed a commit that referenced this pull request Dec 12, 2017
@addaleax @MylesBorins
doc: use better terminology for build machines
1a3aadb 
PR-URL: #17142
Reviewed-By: Vse Mozhet Byt <[email protected]>
Reviewed-By: Gibson Fahnestock <[email protected]>
Reviewed-By: Refael Ackermann <[email protected]>
Reviewed-By: Gireesh Punathil <[email protected]>
Reviewed-By: Anatoli Papirovski <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: Michael Dawson <[email protected]>
@MylesBorins MylesBorins mentioned this pull request Dec 12, 2017
Merged
gibfahn pushed a commit that referenced this pull request Dec 19, 2017
@addaleax @gibfahn
doc: use better terminology for build machines
8441632 
PR-URL: #17142
Reviewed-By: Vse Mozhet Byt <[email protected]>
Reviewed-By: Gibson Fahnestock <[email protected]>
Reviewed-By: Refael Ackermann <[email protected]>
Reviewed-By: Gireesh Punathil <[email protected]>
Reviewed-By: Anatoli Papirovski <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: Michael Dawson <[email protected]>
MylesBorins pushed a commit that referenced this pull request Dec 19, 2017
@addaleax @MylesBorins
doc: use better terminology for build machines
5f522a1 
PR-URL: #17142
Reviewed-By: Vse Mozhet Byt <[email protected]>
Reviewed-By: Gibson Fahnestock <[email protected]>
Reviewed-By: Refael Ackermann <[email protected]>
Reviewed-By: Gireesh Punathil <[email protected]>
Reviewed-By: Anatoli Papirovski <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: Michael Dawson <[email protected]>
@gibfahn gibfahn mentioned this pull request Dec 20, 2017
Closed
gibfahn pushed a commit that referenced this pull request Dec 20, 2017
@addaleax @gibfahn
doc: use better terminology for build machines
eb041a0 
PR-URL: #17142
Reviewed-By: Vse Mozhet Byt <[email protected]>
Reviewed-By: Gibson Fahnestock <[email protected]>
Reviewed-By: Refael Ackermann <[email protected]>
Reviewed-By: Gireesh Punathil <[email protected]>
Reviewed-By: Anatoli Papirovski <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: Michael Dawson <[email protected]>
@gibfahn gibfahn mentioned this pull request Dec 20, 2017
Merged
@MylesBorins MylesBorins mentioned this pull request Dec 20, 2017
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@jasnell jasnell jasnell approved these changes

@Trott Trott Trott approved these changes

@gireeshpunathil gireeshpunathil gireeshpunathil approved these changes

@mhdawson mhdawson mhdawson approved these changes

+4 more reviewers

@apapirovski apapirovski apapirovski approved these changes

@refack refack refack approved these changes

@vsemozhetbyt vsemozhetbyt vsemozhetbyt approved these changes

@gibfahn gibfahn gibfahn approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

doc Issues and PRs related to the documentations.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.