Skip to content

docs: add CONTRIBUTING.md with dev setup, lint/test commands, and PR conventions#1122

Open
hexcreator wants to merge 1 commit into
anthropics:mainfrom
hexcreator:docs/contributing-md
Open

docs: add CONTRIBUTING.md with dev setup, lint/test commands, and PR conventions#1122
hexcreator wants to merge 1 commit into
anthropics:mainfrom
hexcreator:docs/contributing-md

Conversation

@hexcreator

Copy link
Copy Markdown

Summary

Fixes #966.

Adds a CONTRIBUTING.md at the repo root consolidating the contributor workflow that previously had to be reverse-engineered from CLAUDE.md, pyproject.toml, and merged PR history:

  • Dev-dependency install: pip install -e ".[dev]"
  • Git hook setup via scripts/initial-setup.sh
  • Manual lint/format commands, including the check-only variants the pre-push hook and CI actually run (ruff check / ruff format --check)
  • Typecheck (mypy src/) and test (pytest tests/) commands
  • PR title convention (Conventional Commits), matching recent merge history

Also links the new file from the README's ## Development section with a two-line quick setup.

I went with the standalone CONTRIBUTING.md shape (rather than expanding the README) to match the sibling anthropic-sdk-python / anthropic-sdk-typescript repos — happy to fold it into the README instead if that's preferred.

Verification

Every documented command was run in a fresh Python 3.12 venv against a clean clone:

  • pip install -e ".[dev]"
  • python -m ruff check src/ tests/
  • python -m ruff format --check src/ tests/
  • python -m mypy src/
  • python -m pytest tests/ ✓ (1056 passed, 5 skipped)

🤖 Generated with Claude Code

…conventions

Consolidates the contributor workflow that previously lived only in
CLAUDE.md and pyproject.toml: dev-deps install command, manual
lint/format/typecheck/test commands, and the Conventional Commits PR
title format. Links it from the README's Development section.

Fixes anthropics#966

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs] Surface dev-deps install + test/lint commands in README (or add CONTRIBUTING.md)

1 participant