Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix (shared-utils): Improve readability and consistency in code comments (fix #8528) #8529

Merged
merged 1 commit into from
Oct 23, 2018

Conversation

sagirk
Copy link
Contributor

@sagirk sagirk commented Jul 20, 2018

Improvements that apply to all comments:

  • Consistent use of periods
  • Consistent use of commas
  • Consistent capitalization
  • Correct use of articles (a, an, the)

Improvements to specific comments:

  • Correct pluralization in the description for helper functions
  • Re-word for clarity and break into shorter sentences the description
    for polyfillBind function
  • Re-word for clarity the description for genStaticKeys function
  • Add a previously missing description for looseIndexOf function

Fixes: #8528

What kind of change does this PR introduce? (check at least one)

  • Bugfix
  • Feature
  • Code style update
  • Refactor
  • Build-related changes
  • Other, please describe:

Does this PR introduce a breaking change? (check one)

  • Yes
  • No

The PR fulfills these requirements:

If adding a new feature, the PR's description includes:

  • A convincing reason for adding this feature (to avoid wasting your time, it's best to open a suggestion issue first and wait for approval before working on it)

Other information:

Improvements that apply to all comments:
- Consistent use of periods
- Consistent use of commas
- Consistent capitalization
- Correct use of articles (a, an, the)

Improvements to specific comments:
- Correct pluralization in the description for helper functions
- Reword for clarity and break into shorter sentences the description
for `polyfillBind` function
- Reword for clarity the description for `genStaticKeys` function
- Add a previously missing description for `looseIndexOf` function

Fixes: vuejs#8528
@sagirk
Copy link
Contributor Author

sagirk commented Jul 23, 2018

@LinusBorg @yyx990803 The source code is very readable. It was a pleasure to go through shared/util.js. This is my attempt to leave it a bit better than I found it, for the next reader.

I would really appreciate it if you took a look at this or tagged someone who could. Thanks for continuing to work on this awesome library!

Copy link
Member

@LinusBorg LinusBorg left a comment

Choose a reason for hiding this comment

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

Thanks for this 👍

@sagirk
Copy link
Contributor Author

sagirk commented Aug 31, 2018

@LinusBorg @yyx990803 Any chance that this could get merged?

@yyx990803 yyx990803 merged commit af819a0 into vuejs:dev Oct 23, 2018
@sagirk sagirk deleted the fix/shared-util-comments branch October 25, 2018 08:11
f2009 pushed a commit to f2009/vue that referenced this pull request Jan 25, 2019
…omments (vuejs#8529)

Improvements that apply to all comments:
- Consistent use of periods
- Consistent use of commas
- Consistent capitalization
- Correct use of articles (a, an, the)

Improvements to specific comments:
- Correct pluralization in the description for helper functions
- Reword for clarity and break into shorter sentences the description
for `polyfillBind` function
- Reword for clarity the description for `genStaticKeys` function
- Add a previously missing description for `looseIndexOf` function

Fixes: vuejs#8528
aJean pushed a commit to aJean/vue that referenced this pull request Aug 19, 2020
…omments (vuejs#8529)

Improvements that apply to all comments:
- Consistent use of periods
- Consistent use of commas
- Consistent capitalization
- Correct use of articles (a, an, the)

Improvements to specific comments:
- Correct pluralization in the description for helper functions
- Reword for clarity and break into shorter sentences the description
for `polyfillBind` function
- Reword for clarity the description for `genStaticKeys` function
- Add a previously missing description for `looseIndexOf` function

Fixes: vuejs#8528
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Better comments in shared/util.js code
4 participants