Don't recommend using latest rev of reuse-tool in .pre-commit-config.yaml

[ryandesign]

I'm adopting REUSE in my project. The docs say:

This uses pre-commit. Once you have it installed, add this to the .pre-commit-config.yaml in your repository:

repos:
  - repo: https://github.com/fsfe/reuse-tool
    rev: latest
    hooks:
      - id: reuse

Then run pre-commit install.

I created .pre-commit-config.yaml with that content and ran pre-commit install (using pre-commit 2.20.0) and it warned that it does not support setting rev to latest:

[WARNING] The 'rev' field of repo 'https://github.com/fsfe/reuse-tool' 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.
pre-commit installed at .git/hooks/pre-commit

After running pre-commit autoupdate (as suggested in the warning) it changed rev to v1.0.0.

So it appears that one should set rev: v1.0.0 (or whatever the current version of reuse-tool is at the time) and update it (potentially using pre-commit autoupdate) when new versions are released.

[carmenbianca]

Agreed. This should be an easy fix. It's on the horizon.

[ryandesign]

It hasn't been fixed. Please reopen.

[carmenbianca]

For some reason the docs aren't up-to-date.

[ryandesign]

How do we update the docs?

[Pablohn26]

I think this issue is already fixed (documentation is updated) @carmenbianca