Skip to content

Hold only the visible overloads to the README's documented defaults [patch] - #186

Open
matt-edmondson wants to merge 1 commit into
mainfrom
fix/183-readme-api-test-compat-overloads
Open

matt-edmondson wants to merge 1 commit into
mainfrom
fix/183-readme-api-test-compat-overloads

Conversation

@matt-edmondson

Copy link
Copy Markdown
Contributor

Fixes #183

What was wrong

EveryMethodInTheReadmeApiReferenceExistsWithItsDocumentedDefaults required every overload's same-named parameter to carry the README's default. The binary-compatibility overloads added in #166 have no defaults on purpose, because defaults on both sets would make calls ambiguous. So the test has failed on every OS since #178, and main can't release.

Change

The default check now looks only at overloads that aren't marked [EditorBrowsable(EditorBrowsableState.Never)]. Those are the overloads the README documents. Every compatibility overload in TextFilter.BinaryCompatibility.cs carries that attribute. The existence and parameter-name checks run against the same visible set.

Verification

  • dotnet test on this branch: 268 passed, 0 failed
  • With the change reverted: 267 passed, 1 failed (this test)
  • I also changed the README's IsMatch filterType default to TextFilterType.Regex as a temporary edit. The test still fails with IsMatch(filterType) is documented as defaulting to TextFilterType.Regex, so a wrong default on a visible overload is still caught.

Generated by Claude Code

…patch]

The README API test required every overload's same-named parameter to carry
the documented default. The binary-compatibility overloads from #166 have no
defaults by design, so main has been red since #178. They are marked
[EditorBrowsable(Never)] and are not what the README documents, so the default
check now skips them. A wrong default on a visible overload still fails.

Fixes #183

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017vfJW6FzBtSrY5LKUuDYce
@sonarqubecloud

sonarqubecloud Bot commented Nov 4, 2026

Copy link
Copy Markdown

matt-edmondson pushed a commit that referenced this pull request Nov 5, 2026
…from #186)

ReadmeTests fails on main because the EditorBrowsable(Never)
binary-compatibility overloads carry no defaults by design. Ported from
open PR #186 so this PR's CI shows its own result.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017vfJW3SsCYipEZieVhB1tG
matt-edmondson pushed a commit that referenced this pull request Nov 6, 2026
EveryMethodInTheReadmeApiReferenceExistsWithItsDocumentedDefaults fails on
main at 5f420d9. This is #186's change, verbatim, so the two merge cleanly
whichever lands first.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017vfJW5JaSLvVsxrZiNZpKh
matt-edmondson pushed a commit that referenced this pull request Nov 7, 2026
Ports the fix from #186 (for #183). The README API test failed on main
because the binary-compatibility overloads deliberately carry no defaults,
so this PR's CI was red for a reason outside its change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017vfJW4tA1FYwsQrBAjGqs7
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.

main CI is red since #178: the README API test rejects the #166 binary-compatibility overloads, so none of the fixes in #166–#182 can release

2 participants