Skip to content

docs: zero docfx warnings, GitHub navbar icon, README title alignment#34

Merged
tgiachi merged 3 commits into
developfrom
docs/fixes
Jul 2, 2026
Merged

docs: zero docfx warnings, GitHub navbar icon, README title alignment#34
tgiachi merged 3 commits into
developfrom
docs/fixes

Conversation

@tgiachi

@tgiachi tgiachi commented Jul 2, 2026

Copy link
Copy Markdown
Owner

Summary

Phase 1 of the docs improvement plan - all docfx build warnings to zero plus two small theme touches.

  • Template: new main.js (modern-template extension) adding the GitHub icon to the navbar; CSS rule to left-align the <h1 align="center"> titles that package READMEs use (they stay centered on GitHub/NuGet, the site gets consistent typography).
  • READMEs: the 3 relative ../SquidStd.X/README.md links in Vfs.Database/Vfs.S3 now point at the docs site (they were InvalidFileLink warnings when included).
  • Crefs: 4 invalid XML doc crefs repaired (ITuiView.Initialize x2 in TuiView, <c>RegisterCoreServices</c> + IFileWatcherService.Watch(string) in RegisterFileWatcherService). Comments only, zero functional changes.

Test Plan

  • docfx docs/docfx.json - 0 warnings, 0 errors (was 7 warnings)
  • dotnet build 0 errors, no new warnings in touched files; full suite 999/999

@tgiachi
tgiachi merged commit 94bb9dc into develop Jul 2, 2026
2 checks passed
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