Skip to content

docs(NET-22): Bring documentation to release quality - #35

Open
cozminu wants to merge 13 commits into
cozmin/refactorfrom
cozmin/net-22
Open

docs(NET-22): Bring documentation to release quality#35
cozminu wants to merge 13 commits into
cozmin/refactorfrom
cozmin/net-22

Conversation

@cozminu

@cozminu cozminu commented Jul 29, 2026

Copy link
Copy Markdown
Member

Summary

  • Closes every CS1591 (missing XML doc) warning in OpenPayments.Sdk by hand-documenting all real (non-generated) public members, and scopes suppression to only the NSwag-generated model files via a targeted .editorconfig
  • Enables TreatWarningsAsErrors on both OpenPayments.Sdk and OpenPayments.Sdk.HttpSignatureUtils so future undocumented members fail CI instead of silently shipping
  • Adds NuGet packaging metadata and a dedicated README.md to each published package (Interledger.OpenPayments, Interledger.OpenPayments.HttpSignatureUtils), replacing the shared root README as the packed content
  • Fixes stale links in the root README.md and points its Usage section at the new package READMEs instead of duplicating content

Test plan

  • dotnet build OpenPayments.Sdk/OpenPayments.Sdk.csproj -c Release — 0 Warning(s), 0 Error(s)
  • dotnet build OpenPayments.Sdk.HttpSignatureUtils/OpenPayments.Sdk.HttpSignatureUtils.csproj -c Release — 0 Warning(s), 0 Error(s)
  • dotnet build -c Release (whole solution) — 0 Warning(s), 0 Error(s)
  • dotnet test — 63/63 passing
  • dotnet pack both library projects — both nupkgs build and bundle their own README.md
  • Every README code block checked against real, compiling source
  • Independent final whole-branch review (all 13 task-level reviews + one cross-cutting pass) — clean

🤖 Generated with Claude Code

@cozminu cozminu self-assigned this Jul 29, 2026
@cozminu cozminu changed the title Bring documentation to release quality docs(NET-22): Bring documentation to release quality Jul 29, 2026
@cozminu cozminu linked an issue Jul 29, 2026 that may be closed by this pull request
4 tasks
@cozminu cozminu added the documentation Improvements or additions to documentation label Jul 30, 2026
@cozminu
cozminu changed the base branch from main to cozmin/refactor July 31, 2026 09:35
@cozminu
cozminu requested review from golobitch and koekiebox July 31, 2026 09:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Bring documentation to release quality

1 participant