Skip to content

(PATCH): Fix API names in the docs - #74

Merged
PaulTrampert merged 1 commit into
mainfrom
claude/readme-api-names
Sep 12, 2026
Merged

PaulTrampert merged 1 commit into
mainfrom
claude/readme-api-names

Conversation

@PaulTrampert

Copy link
Copy Markdown
Owner

The README and getting-started guide name types and methods that don't exist, so both PATCH snippets fail to compile as written. Spotted while working on #73; split out here so that PR stays focused.

The errors

Where Says Should be
README.md (prose bullet) IPatchObjectFor<PersonWriteModel> IPatchObject<PersonWriteModel>
README.md (snippet — comment and parameter) IPatchObjectFor<PersonWriteModel> IPatchObject<PersonWriteModel>
docs/getting-started.md (snippet) patch.ApplyTo(person) patch.Patch(person)
PTrampert.SimplePatch.Sample/Controllers/PeopleController.cs (comment) IPatchObjectFor<PersonWriteModel> IPatchObject<PersonWriteModel>

The interface is IPatchObject<T> and its single method is T Patch(T target). The sample's comment is the same wrong name sitting directly above a line that already uses the real one, so it was worth fixing in the same pass — the README's snippet is a copy of that controller.

Docs and comments only; no behaviour change. Build is clean and the 23 existing tests pass.

Not touched

PatchJsonConverterFactoryTests.Deserialize_ToIPatchObjectFor_ReturnsObjectWithCorrectOptionalProperties still carries the old name. That's a test method identifier rather than documentation, so I left it rather than widen a docs fix into test code — happy to rename it if you'd like it gone too.

Relationship to #73

Branched from main, not from #73, so the two can merge in either order. #73 appends a new OpenAPI section to the end of README.md and does not touch these lines, so no conflict either way.

🤖 Generated with Claude Code

https://claude.ai/code/session_01RtsmxAyPuVHce2nkVDZh2v


Generated by Claude Code

The README told readers to use IPatchObjectFor<T>, and the getting started
guide called patch.ApplyTo(person). Neither exists — the interface is
IPatchObject<T> and its method is Patch(target) — so both snippets fail to
compile as written. The sample controller carried the same wrong name in a
comment above a line that uses the real one.

Docs and comments only; no behaviour change.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RtsmxAyPuVHce2nkVDZh2v
@github-actions

Copy link
Copy Markdown

✅ PR Title Formatted Correctly

The title of this PR has been updated to match the correct format. Thank you!

@PaulTrampert
PaulTrampert merged commit 5b6ec4b into main Sep 12, 2026
8 checks passed
@PaulTrampert
PaulTrampert deleted the claude/readme-api-names branch September 12, 2026 04:44
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