Skip to content

docs: note virtual environment requirement for pre-commit hooks#745

Merged
ajbozarth merged 1 commit into
generative-computing:mainfrom
ajbozarth:docs/pre-commit-venv-note
Mar 26, 2026
Merged

docs: note virtual environment requirement for pre-commit hooks#745
ajbozarth merged 1 commit into
generative-computing:mainfrom
ajbozarth:docs/pre-commit-venv-note

Conversation

@ajbozarth
Copy link
Copy Markdown
Contributor

@ajbozarth ajbozarth commented Mar 25, 2026

Misc PR

Type of PR

  • Bug Fix
  • New Feature
  • Documentation
  • Other

Description

Adds a note to the installation steps and common issues table clarifying that some pre-commit hooks require dev tools (from the lint and typecheck dependency groups) to be on PATH, and directs contributors to activate the virtual environment before committing.

This was introduced in #709 which moved the ruff hooks to language: system, requiring the tools to be available outside the virtualenv.

Testing

  • Tests added to the respective file if code was changed
  • New code has 100% coverage if code as added
  • Ensure existing tests and github automation passes (a maintainer will kick off the github automation when the rest of the PR is populated)

Some hooks require tools from dev dependency groups to be on PATH.
Add note to installation steps and common issues table directing
contributors to activate the virtual environment before committing.

Relates to generative-computing#744.

Signed-off-by: Alex Bozarth <ajbozart@us.ibm.com>
@ajbozarth ajbozarth self-assigned this Mar 25, 2026
@ajbozarth ajbozarth requested a review from a team as a code owner March 25, 2026 22:08
@ajbozarth ajbozarth added the documentation Improvements or additions to documentation label Mar 25, 2026
@github-actions
Copy link
Copy Markdown
Contributor

The PR description has been updated. Please fill out the template for your PR to be reviewed.

@mergify
Copy link
Copy Markdown

mergify Bot commented Mar 25, 2026

Merge Protections

Your pull request matches the following merge protections and will not be merged until they are valid.

🟢 Enforce conventional commit

Wonderful, this rule succeeded.

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

  • title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert|release)(?:\(.+\))?:

@ajbozarth ajbozarth added this pull request to the merge queue Mar 25, 2026
Merged via the queue into generative-computing:main with commit 9f2e1f0 Mar 26, 2026
10 checks passed
@ajbozarth ajbozarth deleted the docs/pre-commit-venv-note branch March 26, 2026 14:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

bug: git commit require active uv venv to pass pre-commit

2 participants