Skip to content

Conversation

@konard
Copy link
Member

@konard konard commented Sep 14, 2025

Summary

  • Fixed DocFX configuration to use correct target framework (net8 instead of netstandard2.0)
  • Resolved $REPOSITORY_NAME template variables in configuration files
  • Added README.md to csharp directory to fix missing file reference
  • Added required DocFX configuration files (docfx.json, filter.yml, toc.yml)

Test plan

  • Run DocFX locally to verify warnings are fixed
  • Build project successfully with dotnet build
  • Reduced warnings from 6 to 2 harmless file link warnings
  • Eliminated all compilation errors during documentation generation

The remaining 2 warnings are harmless "InvalidFileLink" warnings that occur because DocFX checks for generated API files before they exist. This is normal behavior.

🤖 Generated with Claude Code


Resolves #6

Adding CLAUDE.md with task information for AI processing.
This file will be removed when the task is complete.

Issue: #6
@konard konard self-assigned this Sep 14, 2025
- Update DocFX configuration to use correct target framework (net8 instead of netstandard2.0)
- Resolve $REPOSITORY_NAME template variable in toc.yml and docfx.json
- Add README.md to csharp directory to fix missing reference
- Add required DocFX configuration files (docfx.json, filter.yml, toc.yml)

This fixes the DocFX warnings that were occurring during documentation generation.
The solution reduces warnings from 6 to 2 harmless file link warnings and eliminates all compilation errors.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
@konard konard changed the title [WIP] Fix DocFX warnings Fix DocFX warnings Sep 14, 2025
🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>'
@konard konard marked this pull request as ready for review September 14, 2025 06:00
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.

Fix DocFX warnings

2 participants