Skip to content

docs: rewrite CONTRIBUTING.md - #660

Open
petercorke wants to merge 1 commit into
mainfrom
docs/contributing
Open

docs: rewrite CONTRIBUTING.md#660
petercorke wants to merge 1 commit into
mainfrom
docs/contributing

Conversation

@petercorke

Copy link
Copy Markdown
Owner

Summary

Rewrites .github/CONTRIBUTING.md. Fixes two real defects in the previous version:

  • A dead, never-filled-in empty link at the end (See our typing [style guide]().)
  • Stale references to black/flake8 -- current tooling is ruff ([tool.ruff] in pyproject.toml)

Also adds:

  • The Conventional Commits PR-title note (commitlint.yml already enforces this, just wasn't documented)
  • A pointer to good first issue/help wanted labels for newcomers
  • Explicit target-branch note (main)

Same structure now shared with MVTB and bdsim's rewritten CONTRIBUTING.md (companion PRs), each filled in with that repo's actual tooling/test commands.

Test plan

  • Verified current lint/format tooling is ruff (not black/flake8) via pyproject.toml
  • Verified commitlint.yml exists and actually checks PR titles
  • Verified good first issue/help wanted labels exist (created/aligned this session)

Fixes two real defects (dead empty link at the end, stale black/flake8 references -- actual tooling is ruff), adds the Conventional Commits PR-title note (commitlint.yml already enforces it), and points at good-first-issue/help-wanted labels instead of nothing. Same structure now shared across RTB/MVTB/bdsim.
@codecov

codecov Bot commented Aug 29, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 0.00%. Comparing base (2d24e0d) to head (cd9c619).

Additional details and impacted files
@@          Coverage Diff          @@
##            main    #660   +/-   ##
=====================================
  Coverage   0.00%   0.00%           
=====================================
  Files        143     143           
  Lines      14050   14050           
=====================================
  Misses     14050   14050           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

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