Repository navigation
Support DocFX 2.64+ on all supported Unity versions - #44
Merged
Merged
Conversation
NormandErwan
force-pushed
the
ccr-152be8c1-dynqj8
branch
2 times, most recently
from
October 18, 2026 20:41
6402057 to
501520a
Compare
This was referenced Oct 18, 2026
Closed
6.0 LTS leaves standard support in October 2026. Xref map, csproj warning and README example paths follow to 6000.3. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UcBPq8SrT8Z2nv2UTJxtMH
- Matrix: DocFX 2.60.0/2.64.0/2.77.0/2.81.0 on Unity 6.3, DocFX 2.81.0 on 6.6 - .NET 6 and 8 SDKs: DocFX 2.60 cannot load the project with SDK 8 alone - Build with --warningsAsErrors; fail if Unity API links are missing - Deploy from the DocFX 2.81.0 + Unity 6.3 build Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UcBPq8SrT8Z2nv2UTJxtMH
The job had no Unity references, so DocFX 2.62+ aborts on CS0246. Run in unityci/editor 6000.3.26f1, point UNITY_MANAGED_PATH at its DLLs, install .NET 8 and DocFX 2.81.0, build with --warningsAsErrors. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UcBPq8SrT8Z2nv2UTJxtMH
Two DocFX manual anchors return 404; the other DocFX, Microsoft and GitLab links redirect to the pages now used. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UcBPq8SrT8Z2nv2UTJxtMH
- DocFX x Unity table matching the CI matrix; DocFX 2.64+ and .NET SDK 8+ - Explain the DocFX 2.62 compile-error abort and the CS0246 symptom (#28) - Install with dotnet tool; game-ci image for GitHub and GitLab CI - Say how to adapt the workflow's Unity link check to another project Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UcBPq8SrT8Z2nv2UTJxtMH
Documentation~ at the package root, sources and overwrite globs pointed at Runtime/. Tested with DocFX 2.81.0 on a package-shaped copy. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UcBPq8SrT8Z2nv2UTJxtMH
- Unity LTS group: ProjectVersion.txt, game-ci image tags, xref map major.minor - Unity Update group: the 6.6 matrix entry, from the SUPPORTED release stream - DocFX group: the latest-DocFX entries and README row; older tested versions stay pinned - CI lines and the README row carry `renovate:` markers the regex managers match Verified with a local `renovate --platform=local --dry-run=lookup` on an aged copy: all 12 occurrences get an update, in 3 branches. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UcBPq8SrT8Z2nv2UTJxtMH
NormandErwan
force-pushed
the
ccr-152be8c1-dynqj8
branch
from
October 19, 2026 12:36
501520a to
a6b7037
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Brings the example up to date with the Unity versions supported today (6.3 LTS, 6.6) and proves which DocFX versions work, in CI.
Closes #20
Commits
chore: update Unity to 6000.3.26f1ProjectVersion.txt, xref map6000.0→6000.3,.csprojwarning and README example paths (6.0 LTS leaves standard support in Oct 2026)ci: test DocFX 2.60-2.81 …--warningsAsErrors, Unity link check, deploy from one matrix jobci(gitlab): build with Unity DLLs …UNITY_MANAGED_PATHset, .NET 8 + DocFX 2.81.0,--warningsAsErrorsdocs(readme): replace dead and redirected …docs(readme): DocFX and Unity compatibilitydotnet tool, how to adapt the link checkdocs(readme): document the Unity package layout (#20)Documentation~at the package root, globs pointed atRuntime/chore(renovate): keep Unity, xref map and DocFX …renovate:markers; groups Unity LTS, Unity Update, DocFXBuild matrix (DocFX × Unity):
--warningsAsErrorsplus the link check catch the failure behind #28: since DocFX 2.62.0 (dotnet/docfx#8397) missing Unity references abort the build, while 2.60/2.61 emit pages without Unity links with only warnings. The GitLab job had no Unity references at all, so it hit exactly that.Every matrix entry must pass for the site to deploy: a red legacy entry blocks deployment on purpose.
Verification
run:step of the GitHub build job replayed locally for all 5 matrix entries: green. DocFX 2.81.0 build green at each of the 7 commits.NuGet.Frameworks), hence the .NET 6 SDK in CI.pagesscript replayed withdocker runin its own image: 0 warnings, 5 Unity links to6000.3docs. Not run on GitLab itself.Runtime/,Documentation~/) built with DocFX 2.81.0: 0 warnings, Unity links and namespace overwrite present.dotnet tool update -g docfxanddocfx Documentation/docfx.json --serverun.renovate-config-validatorpasses;renovate --platform=local --dry-run=lookupon an aged copy proposes all 12 updates in 3 branches (unity-lts,unity-update,docfx), older tested DocFX versions untouched.actionlint: clean.Known limits
-3.2.2) is not managed by Renovate; a Unity bump whose image only exists under a newer suffix fails the Renovate PR's CI.6000.3,6000.6) and example paths are edited by hand when a new minor arrives.🤖 Generated with Claude Code
https://claude.ai/code/session_01UcBPq8SrT8Z2nv2UTJxtMH