Skip to content

Update CLAUDE.md to simplify pre-commit documentation#18710

Merged
harupy merged 1 commit intomlflow:masterfrom
harupy:update-claude-md-precommit-docs
Nov 11, 2025
Merged

Update CLAUDE.md to simplify pre-commit documentation#18710
harupy merged 1 commit intomlflow:masterfrom
harupy:update-claude-md-precommit-docs

Conversation

@harupy
Copy link
Member

@harupy harupy commented Nov 6, 2025

🛠 DevTools 🛠

Open in GitHub Codespaces

Install mlflow from this PR

# mlflow
pip install git+https://github.com/mlflow/mlflow.git@refs/pull/18710/merge
# mlflow-skinny
pip install git+https://github.com/mlflow/mlflow.git@refs/pull/18710/merge#subdirectory=libs/skinny

For Databricks, use the following command:

%sh curl -LsSf https://raw.githubusercontent.com/mlflow/mlflow/HEAD/dev/install-skinny.sh | sh -s pull/18710/merge

What changes are proposed in this pull request?

Simplifies the pre-commit setup documentation in CLAUDE.md by:

  • Adding the install-bin command to the initial setup
  • Removing the detailed section about external tools and SKIP workaround

The documentation now assumes all tools are properly installed via install-bin, making the setup process clearer for new contributors.

How is this PR tested?

  • Manual tests (verified documentation accuracy)

Does this PR require documentation update?

  • No. You can skip the rest of this section.

Release Notes

Is this a user-facing change?

  • No. You can skip the rest of this section.

How should the PR be classified in the release notes? Choose one:

  • rn/none - No description will be included. The PR will be mentioned only by the PR number in the "Small Bugfixes and Documentation Updates" section

Should this PR be included in the next patch release?

  • Yes (this PR will be cherry-picked and included in the next patch release)
  • No (this PR will be included in the next minor release)

🤖 Generated with Claude Code

Signed-off-by: harupy <17039389+harupy@users.noreply.github.com>
@github-actions github-actions bot added v3.6.0 rn/none List under Small Changes in Changelogs. labels Nov 6, 2025
Comment on lines -240 to -257
**Note about external tools**: Some pre-commit hooks require external tools that aren't Python packages:

- `taplo` - TOML formatter
- `typos` - Spell checker
- `conftest` - Policy testing tool

To install these tools:

```bash
# Install all tools at once (recommended)
uv run --only-group lint bin/install.py
```

This automatically downloads and installs the correct versions of all external tools to the `bin/` directory. The tools work on both Linux and ARM Macs.

These tools are optional. Use `SKIP=taplo,typos,conftest` if they're not installed.

**Note**: If the typos hook fails, you only need to fix typos in code that was changed by your PR, not pre-existing typos in the codebase.
Copy link
Member Author

@harupy harupy Nov 6, 2025

Choose a reason for hiding this comment

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

These were added before the install-bin was introduced.

@harupy harupy requested a review from Copilot November 6, 2025 07:50
@harupy harupy added the team-review Trigger a team review request label Nov 6, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR simplifies the pre-commit documentation by consolidating the installation process and removing redundant information about external tools. The key change is to automatically handle external tool installation through the install-bin pre-commit hook instead of requiring manual setup.

  • Adds the install-bin hook execution to the setup instructions
  • Removes detailed documentation about manual external tool installation
  • Removes instructions for skipping hooks when external tools are unavailable

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@B-Step62
Copy link
Collaborator

B-Step62 commented Nov 7, 2025

@harupy do we need this PR by 3.6.0?

@harupy harupy removed the v3.6.0 label Nov 7, 2025
@harupy
Copy link
Member Author

harupy commented Nov 7, 2025

@B-Step62 No, removed the label :)

Copy link
Collaborator

@serena-ruan serena-ruan left a comment

Choose a reason for hiding this comment

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

LGTM!

@harupy harupy added this pull request to the merge queue Nov 11, 2025
Merged via the queue into mlflow:master with commit 166ced5 Nov 11, 2025
62 of 64 checks passed
@harupy harupy deleted the update-claude-md-precommit-docs branch November 11, 2025 04:47
BenWilson2 pushed a commit to BenWilson2/mlflow that referenced this pull request Nov 14, 2025
Signed-off-by: harupy <17039389+harupy@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

rn/none List under Small Changes in Changelogs. team-review Trigger a team review request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants