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

Improve pre-commit hook and docs #1774

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

adamchainz
Copy link

What is the purpose of this pull request? (put an "X" next to item)

[x] Documentation update

What changes did you make? (Give an overview)

  • Add the description field that will appear on https://pre-commit.com/hooks.html (I’m about to submit it).

  • Describe what pre-commit does a little more.

  • Describe the pre-commit autoupdate step required to pin to a specific version rather than master. Using master could be broken, and isn't reproducible between environments. Indeed pre-commit warns if you use master:

    [WARNING] The 'rev' field of repo 'https://github.com/standard/standard' appears to be a mutable reference (moving tag / branch).  Mutable references are never updated after first install and are not supported.  See https://pre-commit.com/#using-the-latest-version-for-a-repository for more details.  Hint: `pre-commit autoupdate` often fixes this.
    

Which issue (if any) does this pull request address?

No issue.

Is there anything you'd like reviewers to focus on?

Nope.

* Add the `description` field that will appear on https://pre-commit.com/hooks.html (I’m about to submit it).
* Describe what pre-commit does a little more.
* Describe the `pre-commit autoupdate` step required to pin to a specific version rather than `master`. Using `master` could be broken, and isn't reproducible between environments. Indeed pre-commit warns if you use `master`:

  ```
  [WARNING] The 'rev' field of repo 'https://github.com/standard/standard' appears to be a mutable reference (moving tag / branch).  Mutable references are never updated after first install and are not supported.  See https://pre-commit.com/#using-the-latest-version-for-a-repository for more details.  Hint: `pre-commit autoupdate` often fixes this.
  ```
@welcome
Copy link

welcome bot commented Feb 3, 2022

🙌 Thanks for opening this pull request! You're awesome.

Copy link
Member

@LinusU LinusU left a comment

Choose a reason for hiding this comment

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

Not too familiar with how pre-commit works, but LGTM 👍

Copy link
Member

@theoludwig theoludwig left a comment

Choose a reason for hiding this comment

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

Thank you! 😄

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: No status
Development

Successfully merging this pull request may close these issues.

None yet

3 participants