Skip to content

docs: add CONTRIBUTING.md with dev setup, lint, test, and PR guidelines#998

Open
2023Anita wants to merge 1 commit into
anthropics:mainfrom
2023Anita:docs/add-contributing
Open

docs: add CONTRIBUTING.md with dev setup, lint, test, and PR guidelines#998
2023Anita wants to merge 1 commit into
anthropics:mainfrom
2023Anita:docs/add-contributing

Conversation

@2023Anita
Copy link
Copy Markdown

Summary

Add CONTRIBUTING.md at repo root and link it from README's Development section. Surfaces dev-dependency install, manual lint/typecheck/test commands, and PR title conventions.

Motivation

Currently, external contributors must:

  1. Read pyproject.toml to discover the dev extras group
  2. Open CLAUDE.md (agent-facing) to find lint/test commands
  3. Scan merged PR history to infer the Conventional Commits title format

CONTRIBUTING.md consolidates all of this in one place a human contributor naturally looks.

Verification

  • python -m ruff check CONTRIBUTING.md — not applicable (Markdown)
  • Manual: all commands in CONTRIBUTING.md match those in CLAUDE.md and pyproject.toml
  • README link navigates to CONTRIBUTING.md

Risk / Compatibility

Zero risk. Documentation-only change. No code, config, or behavior changes.

Related

Closes #966

Surface dev-dependency install command, manual lint/typecheck/test
commands, and PR title conventions. Previously this information was
scattered across CLAUDE.md (agent-facing), pyproject.toml, and
merged PR history.

Closes anthropics#966
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