Skip to content

docs: note newly-ignored failure mode in new_test.rs module doc - #65

Open
cargo-affected-bot wants to merge 2 commits into
mainfrom
docs/new-test-module-doc-failure-modes
Open

docs: note newly-ignored failure mode in new_test.rs module doc#65
cargo-affected-bot wants to merge 2 commits into
mainfrom
docs/new-test-module-doc-failure-modes

Conversation

@cargo-affected-bot

Copy link
Copy Markdown
Collaborator

The module doc in tests/functional/new_test.rs opens with "Two failure modes are guarded here" and then enumerates exactly two: a perpetually-#[ignore]d test not reading as new forever, and the listing being built with the run's cargo features. But the file also contains newly_ignored_test_excluded_from_affected, which guards a third, distinct failure mode: a test that becomes #[ignore]d after collection keeps its coverage rows, so a later diff overlapping those rows would pull it into affected — and that goes through a different code path (the affected selection loop) than the new-detection split the header describes.

Both the doc header and that test were introduced in the same commit (d5c7dd0), so the "two" was imprecise from the start. This broadens the wording to "Several" and adds a sentence for the newly-ignored mode, so the header matches the tests below it.

Phrased count-agnostically on purpose: open PR #41 adds a fifth test (a positional-filter mode) to this same file without touching the header, so "Several" stays accurate whichever of the two lands first. The change is comment-only — no behavioral test applies. Surfaced by the nightly rolling survey.

The module doc says "Two failure modes are guarded here" and enumerates
only the perpetually-ignored case and the feature-gating case. The file
also guards newly_ignored_test_excluded_from_affected — a distinct mode
where a test ignored after collection keeps its coverage rows and must be
dropped from the `affected` selection (a different path than new-test
detection). Broaden the wording to "Several" and describe that mode so
the header matches the tests.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…doc-failure-modes

# Conflicts:
#	tests/functional/new_test.rs
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