Skip to content

Add contributing guide for developers#274

Open
brunns wants to merge 1 commit intohamcrest:mainfrom
brunns:add-contributing-guide
Open

Add contributing guide for developers#274
brunns wants to merge 1 commit intohamcrest:mainfrom
brunns:add-contributing-guide

Conversation

@brunns
Copy link
Member

@brunns brunns commented Feb 12, 2026

Summary

Add comprehensive CONTRIBUTING.md to help new contributors understand the development workflow.

Contents

  • Development Setup: Installing dependencies, pre-commit hooks, using tox
  • Running Tests: pytest, tox, coverage, testing across Python versions
  • Code Style and Linting: black, ruff, pre-commit hooks
  • Type Checking: mypy, type hint tests
  • Adding Changelog Entries: towncrier workflow (REQUIRED for code changes)
  • Submitting Pull Requests: PR guidelines, CI workflow, branch naming
  • Release Process: For maintainers - using release.sh and automated publishing

Key Points

  • ⚠️ Changelog entries are required for all code changes (but not for documentation-only changes)
  • 🧪 Contributors should run tox -s before submitting PRs
  • 🤖 CI runs automatically on all pull requests
  • 📦 Releases are automated via git tags

This guide should help reduce friction for new contributors and ensure consistent quality across contributions.

🤖 Generated with Claude Code

Add comprehensive CONTRIBUTING.md covering:
- Development setup and dependencies
- Running tests with pytest and tox
- Code style and linting with pre-commit
- Type checking with mypy
- Adding changelog entries with towncrier
- PR submission guidelines and CI workflow
- Release process for maintainers

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@brunns brunns requested a deployment to publish-test-release February 12, 2026 14:19 — with GitHub Actions Waiting
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.

1 participant