Skip to content

tools: capitalize sentences - #24808

Closed
BridgeAR wants to merge 1 commit into
nodejs:masterfrom
BridgeAR:capitalize-letters
Closed

tools: capitalize sentences#24808
BridgeAR wants to merge 1 commit into
nodejs:masterfrom
BridgeAR:capitalize-letters

Conversation

@BridgeAR

@BridgeARBridgeAR commented Dec 3, 2018

Copy link
Copy Markdown
Member

This adds the capitalized-comments eslint rule to verify that
actual sentences use capital letters as starting letters. It ignores
special words and all lines below 62 characters. That way it will
mainly detect sentences. This way the code changes are kept low.

Checklist
  • make -j4 test (UNIX), or vcbuild test (Windows) passes
  • tests and/or benchmarks are included
  • documentation is changed or added
  • commit message follows commit guidelines

@nodejs-github-bot

nodejs-github-bot commented Dec 3, 2018

Copy link
Copy Markdown
Collaborator

@BridgeAR build started: https://ci.nodejs.org/blue/organizations/jenkins/node-test-pull-request-lite-pipeline/detail/node-test-pull-request-lite-pipeline/1805/pipeline

@nodejs-github-botnodejs-github-bot added the lib / src Issues and PRs related to general changes in the lib or src directory. label Dec 3, 2018
@BridgeAR

BridgeAR commented Dec 3, 2018

Copy link
Copy Markdown
MemberAuthor

As a note: this rule is able to autofix.

vsemozhetbyt
vsemozhetbyt reviewed Dec 3, 2018
View reviewed changes
Comment threadtest/parallel/test-buffer-read.js Outdated
@BridgeAR

BridgeAR commented Dec 5, 2018

Copy link
Copy Markdown
MemberAuthor

This needs some reviews.

@nodejs/documentation PTAL (it is somewhat loosely related to docs).

@BridgeAR

BridgeAR commented Dec 6, 2018

Copy link
Copy Markdown
MemberAuthor

@nodejs/linting PTAL

@BridgeAR

BridgeAR commented Dec 6, 2018

Copy link
Copy Markdown
MemberAuthor

CI https://ci.nodejs.org/job/node-test-pull-request-lite-pipeline/1855/

rubys
rubys reviewed Dec 6, 2018
View reviewed changes
Comment threaddoc/api/dns.md Outdated
@BridgeAR

BridgeAR commented Dec 8, 2018•
edited by Trott
Loading

Copy link
Copy Markdown
MemberAuthor

CI https://ci.nodejs.org/job/node-test-pull-request-lite-pipeline/1867/ ✔️

@BridgeARBridgeAR added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Dec 8, 2018
Trott
Trott reviewed Dec 8, 2018
View reviewed changes

@TrottTrott left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Since a review was requested from me:

No objection. I'm not a fan of all the churn for something like this, but I'm also not a fan of watching nit after nit to newcomer contributors telling them to capitalize comments, so I'm good with it.

One nit on the commit message: I'd prefer if "comments" appeared somewhere in the first line of the commit message so that someone scanning commits doesn't think this is about other text.

@Trott

Trott commented Dec 8, 2018

Copy link
Copy Markdown
Member

Needs a rebase. (One test was moved from parallel to sequential.)

@TrottTrott removed the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Dec 8, 2018
@ryzokuken

ryzokuken commented Dec 8, 2018

Copy link
Copy Markdown
Contributor

No objection. I'm not a fan of all the churn for something like this, but I'm also not a fan of watching nit after nit to newcomer contributors telling them to capitalize comments, so I'm good with it.

I see where you're coming from. That said, I think it's important that nits like these are handled by the tooling. Ideally, IMHO, there should be no nits on the actual PR. The linting setup should be powerful enough to take care of all possible nits and more. This PR helps in that respect, I feel.

ryzokuken
ryzokuken approved these changes Dec 8, 2018
View reviewed changes

@ryzokukenryzokuken left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Great catch.

@Trott

Trott commented Dec 8, 2018

Copy link
Copy Markdown
Member

That said, I think it's important that nits like these are handled by the tooling.

@ryzokuken Yeah, that's what I was trying to say. I'm not a fan of Collaborators leaving nits about this sort of thing all the time. I'd prefer the tooling do it. So, despite the churn, I"m OK with this.

@BridgeAR
tools: capitalize sentences
26d88c8
This adds the `capitalized-comments` eslint rule to verify that
actual sentences use capital letters as starting letters. It ignores
special words and all lines below 62 characters.
@BridgeAR

BridgeAR commented Dec 10, 2018

Copy link
Copy Markdown
MemberAuthor

Rebased

CI https://ci.nodejs.org/job/node-test-pull-request-lite-pipeline/1883/

@BridgeARBridgeAR added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Dec 10, 2018
BridgeAR added a commit to BridgeAR/node that referenced this pull request Dec 10, 2018
@BridgeAR
tools: capitalize sentences
1f85ea9
This adds the `capitalized-comments` eslint rule to verify that
actual sentences use capital letters as starting letters. It ignores
special words and all lines below 62 characters.
PR-URL: nodejs#24808
Reviewed-By: Sam Ruby <rubys@intertwingly.net>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: Ujjwal Sharma <usharma1998@gmail.com>
Reviewed-By: Sakthipriyan Vairamani <thechargingvolcano@gmail.com>
@BridgeAR

BridgeAR commented Dec 10, 2018

Copy link
Copy Markdown
MemberAuthor

Landed in 1f85ea9

BethGriggs pushed a commit that referenced this pull request Dec 17, 2018
@BridgeAR@BethGriggs
tools: capitalize sentences
e140d41
This adds the `capitalized-comments` eslint rule to verify that
actual sentences use capital letters as starting letters. It ignores
special words and all lines below 62 characters.
PR-URL: #24808
Reviewed-By: Sam Ruby <rubys@intertwingly.net>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: Ujjwal Sharma <usharma1998@gmail.com>
Reviewed-By: Sakthipriyan Vairamani <thechargingvolcano@gmail.com>
@BethGriggsBethGriggs mentioned this pull request Dec 18, 2018
Merged
@beevelopbeevelop mentioned this pull request Dec 18, 2018
Closed
refack pushed a commit to refack/node that referenced this pull request Jan 14, 2019
@BridgeAR@refack
tools: capitalize sentences
f0aac1f
This adds the `capitalized-comments` eslint rule to verify that
actual sentences use capital letters as starting letters. It ignores
special words and all lines below 62 characters.
PR-URL: nodejs#24808
Reviewed-By: Sam Ruby <rubys@intertwingly.net>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: Ujjwal Sharma <usharma1998@gmail.com>
Reviewed-By: Sakthipriyan Vairamani <thechargingvolcano@gmail.com>
@BridgeAR
BridgeAR deleted the capitalize-letters branch January 20, 2020 11:44
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@TrottTrottTrott left review comments
@trivikrtrivikrtrivikr approved these changes
+4 more reviewers
@vsemozhetbytvsemozhetbytvsemozhetbyt left review comments
@rubysrubysrubys approved these changes
@thefourtheyethefourtheyethefourtheye approved these changes
@ryzokukenryzokukenryzokuken approved these changes
Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

author readyPRs that have at least one approval, no pending requests for changes, and a CI started.lib / srcIssues and PRs related to general changes in the lib or src directory.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

9 participants

@BridgeAR@nodejs-github-bot@Trott@ryzokuken@rubys@thefourtheye@vsemozhetbyt@trivikr@BethGriggs