Skip to content

docs: count the JustDummies analyzers in the mutation pages - #328

Merged
Reefact merged 1 commit into
mainfrom
claude/automated-mutation-testing-4okfe0
Jul 27, 2026
Merged

docs: count the JustDummies analyzers in the mutation pages#328
Reefact merged 1 commit into
mainfrom
claude/automated-mutation-testing-4okfe0

Conversation

@Reefact

@Reefact Reefact commented Jul 27, 2026

Copy link
Copy Markdown
Owner

Summary

ADR-0044 added a third leg to the JustDummies mutation matrix and a fifth Stryker configuration at break: 0. The two workflow pages were written before it and still described the state without it, so three of their claims had quietly gone false. This pull request brings them back in line with the workflows they document. No code, no workflow and no configuration is touched.

Type of change

  • Bug fix
  • New feature
  • Breaking change
  • Refactoring
  • Analyzer / diagnostic change
  • Tests
  • Documentation
  • Build / CI / tooling

Changes

Where Said Says now
mutation.{en,fr}.md "four projects have no bar yet" five, the JustDummies analyzers included
justdummies-mutation.{en,fr}.md — what it covers "the two JustDummies packages" three components
— its configurations justdummies.json and justdummies-xunit.json all three, justdummies-analyzers.json included
— the migration checklist take two configurations to the new repository three, and the solution field of all three

The last row is the one that mattered most. The "when JustDummies moves to its own repository" checklist told a future maintainer to take two configurations across; followed literally, it would have left the analyzers leg behind — a gate leg silently lost in the move, which is precisely what a checklist exists to prevent.

The pages now also say why that leg carries no bar, because its reason is not the others'. The four originals are waiting on a measured sweep. This one reports rather than blocks because its residual survivors are the analyzer-infrastructure and descriptor-string mutants the FirstClassErrors analyzers carry too — so Monday's sweep will not hand it a bar the way it will the others.

Two things deliberately left alone:

  • The section titles. mutation.{en,fr}.md link into them by anchor (#justdummies-has-no-score-threshold-yet); renaming them would break the cross-reference, so the new material was added inside instead.
  • Every threshold figure. The pages quote none — they describe the ratchet, not its current values — so raising testing to 90 and justdummies-xunit to 80 in Assert what the mutation gate found unasserted in the two test-support packages #324 left them accurate, and nothing there needed touching.

Testing

  • dotnet build FirstClassErrors.sln
  • dotnet test FirstClassErrors.sln
  • Analyzer tests pass (FirstClassErrors.Analyzers.UnitTests)

None were run, and none apply: the diff is prose in four Markdown files. What was verified: no stale claim survives anywhere in doc/handwritten/for-maintainers/workflows/, every relative link in the four edited files resolves to a file that exists, both anchors referenced across pages still match a heading, and the commit message passes the repository's own tools/commit-lint/lint-commit-message.sh.

Documentation

  • Public API / error documentation updated
  • README / doc/ updated
  • French translation (doc/handwritten/for-users/README.fr.md) updated if user-facing behavior changed
  • No documentation change required

Both boxes are ticked on purpose: this is the documentation change, and the French maintainer pages are updated alongside the English ones as the bilingual convention requires. doc/handwritten/for-users/README.fr.md is untouched — the user-facing documentation is unaffected, since no user-facing behaviour changed.

Architecture decisions

  • No architectural decision in this pull request
  • New decision recorded — ADR drafted as Proposed: ADR-____
  • Supersedes an existing ADR — successor proposed, status not flipped: ADR-____
  • ⚠️ Conflicts with an existing ADR — flagged for the maintainer: ADR-____

This records no decision; it makes the documentation match one already taken and merged (ADR-0044).

Related issues

None.


Generated by Claude Code

ADR-0044 added a third leg to the JustDummies mutation matrix and a fifth
Stryker configuration at `break: 0`, but the two workflow pages still
described the state before it. Three claims had gone false: the JustDummies
gate covering "two packages", its configurations being `justdummies.json`
and `justdummies-xunit.json` alone, and "four projects have no bar yet".

Correct the count everywhere it is stated — including the migration checklist,
where taking only two configurations to the new repository would have dropped
the analyzers leg — and say why that leg carries no bar: unlike the others it
is not waiting on a sweep, it reports rather than blocks because its residual
survivors are the analyzer-infrastructure mutants the FirstClassErrors
analyzers carry too.

The section titles are left untouched: `mutation` links to them by anchor.

No threshold figure was stale — the pages quote none, so raising `testing` to
90 and `justdummies-xunit` to 80 left them accurate.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TGVx78thdSPSQY9pRRsP45
@Reefact
Reefact enabled auto-merge July 27, 2026 21:38
@Reefact
Reefact merged commit 2edc45c into main Jul 27, 2026
29 checks passed
@Reefact
Reefact deleted the claude/automated-mutation-testing-4okfe0 branch July 27, 2026 21:41
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