Skip to content

Replace stale template placeholder text in docfx API README#32

Merged
Chris-Wolfgang merged 1 commit into
mainfrom
fix/docfx-readme-template-text
Apr 2, 2026
Merged

Replace stale template placeholder text in docfx API README#32
Chris-Wolfgang merged 1 commit into
mainfrom
fix/docfx-readme-template-text

Conversation

@Chris-Wolfgang

Copy link
Copy Markdown
Owner

Summary

  • Replaced the outdated "Template Placeholders" section in docfx_project/api/README.md with a "Namespace" section that accurately describes what the generated API documentation covers

Test plan

  • Verified the markdown renders correctly
  • No functional impact -- documentation-only change

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 1, 2026 18:37

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the DocFX api/README.md to remove stale template placeholder guidance and replace it with an accurate description of what the generated API reference documentation contains.

Changes:

  • Replaced the “Template Placeholders” section with a “Namespace” section.
  • Clarified that the generated API docs cover Wolfgang.Etl.TestKit and its sub-namespaces.

@Chris-Wolfgang Chris-Wolfgang merged commit 3c3305b into main Apr 2, 2026
12 checks passed
@Chris-Wolfgang Chris-Wolfgang deleted the fix/docfx-readme-template-text branch April 2, 2026 03:10
Chris-Wolfgang added a commit that referenced this pull request May 14, 2026
Backport of repo-template PR #339. The 'Fetch trusted configuration files
from main branch' step writes .editorconfig / Directory.Build.props /
BannedSymbols.txt back via 'Out-File -Encoding UTF8' which writes UTF-8
*with* BOM. The .NET analyzer engine appears to ignore .editorconfig
files prefixed by a BOM, so project-level severity overrides don't apply
on CI even though they apply locally — analyzers fire at default severity
and TreatWarningsAsErrors then escalates them to errors.

Switch to 'Out-File -Encoding UTF8NoBOM' (PS 6+; the runner uses pwsh).

Diagnosed against Chris-Wolfgang/In-memory-Logger PR #32 / run
24996715587. See Chris-Wolfgang/repo-template#339 for the full write-up.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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