[Docs] Consistent pre-commit/lint

README.md

@@ -326,13 +326,21 @@ code take effect without needing to reinstall.
 
 ## Linting
 
-To run linting checks:
+We use `pre-commit` to run ruff, pyright, and other checks automatically.
 
+– One-time setup (installs the git hook):
 ```bash
 pip install pre-commit
+pre-commit install
+```
+
+– Run all checks across the repository:
+```bash
 pre-commit run --all-files
 ```
 
+Note: You can still run the underlying tools directly via `./lint.sh [fix|check|unsafe]`.
+
 ## License
 
 Helion is BSD-style licensed, as found in the LICENSE file.

docs/installation.md

@@ -126,10 +126,14 @@ If you installed with `[dev]`, you get additional development tools:
 - **pytest** - Test runner
 - **pre-commit** - Code formatting and linting hooks
 
-Set up pre-commit hooks for development:
+Set up and use pre-commit for linting:
 
 ```bash
+# Install pre-commit hooks into your local git repo (one-time)
 pre-commit install
+
+# Run all checks across the repository
+pre-commit run --all-files
 ```
 
 ## Optional Dependencies