Skip to content

Conversation

@schlich
Copy link

@schlich schlich commented Oct 15, 2025

This pull request updates the development workflow instructions in CONTRIBUTING.md to ensure consistency with the project's CI checks and to help contributors catch issues earlier. The changes clarify and strengthen requirements for formatting, linting, testing, and lockfile validation.

Updated the pre-submission checklist to match CI requirements more closely:
- Added --check flag to cargo fmt to verify formatting without modifying files
- Added -D warnings flag to cargo clippy to treat warnings as errors
- Added --all flag to cargo test to run tests across all workspace members
- Added lockfile check command (cargo check --locked)
- Included note about CI testing with multiple feature combinations

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Copy link
Member

@sholderbach sholderbach left a comment

Choose a reason for hiding this comment

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

Thanks for improving that!

CONTRIBUTING.md Outdated
Comment on lines 55 to 58
- the lockfile check

```shell
cargo check --locked --all-targets --all
Copy link
Member

Choose a reason for hiding this comment

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

Not sure how many times that is actually relevant? Have you run into that failing?

Copy link
Author

Choose a reason for hiding this comment

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

hi @sholderbach thanks for the feedback! I think i was a bit thrown off by the github actions CI calling this command, as parity with CI was the priority for this PR. It seems like clippy covers this behavior (checking that Cargo.lock matches Cargo.toml) and so i've edited the instructions with some consolidated commands and clarifying notes. While I believe this should cover things as far as matching CI, I wonder if some of the steps in the gh workflow can be consolidated?

schlich and others added 2 commits October 21, 2025 16:39
…ONTRIBUTING.md

Rework the "To make the CI gods happy" section to mirror CI behavior:
add explanatory preamble and section headers, update the Clippy command to
use `--locked --all-targets --all-features`, switch tests to the
`cargo nextest run --all --all-features` invocation, and add notes about
the flags and nextest runner.
@schlich schlich changed the title docs: improve CONTRIBUTING.md with stricter CI check commands docs: improve CONTRIBUTING.md to more closely match CI execution Oct 22, 2025
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.

2 participants