Skip to content

docs: audit other markdown — code samples + PackageReference (#139)#214

Merged
Chris-Wolfgang merged 1 commit into
vNextfrom
docs/139-other-md
Jun 27, 2026
Merged

docs: audit other markdown — code samples + PackageReference (#139)#214
Chris-Wolfgang merged 1 commit into
vNextfrom
docs/139-other-md

Conversation

@Chris-Wolfgang

Copy link
Copy Markdown
Owner

Summary

Markdown audit for accuracy across CONTRIBUTING / SECURITY / CODE_OF_CONDUCT, PR template, .github/copilot-instructions.md, docfx_project/**/*.md, and docs/**/*.md. Most files passed end-to-end against current repo state. Two real bugs fixed:

  • .github/copilot-instructions.md — stray spaces in 7 code samples (Try. Run, string. IsNullOrWhiteSpace, result. Succeeded, result. ErrorMessage, Result<TResponse>. Failure, Result. Failure, Result. Success) meant the snippets would not compile if copy-pasted. The RunAsync<T> XML-doc example was also missing the CancellationToken parameter that the real API takes.
  • docfx_project/docs/getting-started.mdPackageReference example pinned to 0.3.0; bumped to 0.3.1 (latest published tag).

Files verified accurate (no change): CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md, PR template, README-FORMATTING.md, DOCFX-VERSION-PICKER.md, WORKFLOW_SECURITY.md, RELEASE-WORKFLOW-SETUP.md, docfx_project/index.md, docfx_project/api/index.md, docfx_project/docs/{index,introduction,setup}.md.

Stacking

Based on #213#212#211 → vNext.

Closes #139.

…started version (#139)

Markdown audit per the tier-1 issue. Most files are accurate against
current repo state (CONTRIBUTING, SECURITY, CODE_OF_CONDUCT, PR template,
README-FORMATTING, DOCFX-VERSION-PICKER, WORKFLOW_SECURITY, docfx_project
index/introduction/setup, RELEASE-WORKFLOW-SETUP) — verified end-to-end.

Two real bugs found and fixed:

- .github/copilot-instructions.md — stray spaces in 7 code samples
  (`Try. Run`, `string. IsNullOrWhiteSpace`, `result. Succeeded`, etc.)
  meant the snippets would not compile if copy-pasted; also the
  RunAsync<T> XML-doc example was missing the CancellationToken
  parameter that the real API takes.

- docfx_project/docs/getting-started.md — PackageReference example
  showed v0.3.0; bumped to v0.3.1 (latest published tag).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@Chris-Wolfgang Chris-Wolfgang changed the base branch from docs/135-138-readme to vNext June 27, 2026 20:19
@Chris-Wolfgang Chris-Wolfgang merged commit 9c8ed0d into vNext Jun 27, 2026
@Chris-Wolfgang Chris-Wolfgang deleted the docs/139-other-md branch June 27, 2026 20:25
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