docs: final consistency review across all documentation PRs

[JusterZhu]

Closes #55

Summary

This PR captures the final consistency review for the non-firmware documentation.

Review Results: 30/31 checks pass (96.8%)

1. Terminology Consistency ✅

• Role names (Client/Upgrade/Server/Packet/Tools/Bowl) consistent across all pages
• Differential/Patch terminology: "Differential" for component, "Patch Package" for artifact
• OSS/Server modes clearly distinguished
• versions.json field names match src/Server/Program.cs implementation
• GeneralUpdateBootstrap API patterns match current Samples code

2. Link Validation ✅

• All cross-page links verified in beginner (docs: add beginner GeneralUpdate cookbook #62) and advanced (docs: write advanced cookbook for production and automation workflows #64) cookbooks
• Sidebar references (PR docs: define Docusaurus IA, sidebar structure, and i18n layout #63) all point to existing files
• External GitHub links verified

3. Sidebar Navigation ✅

• 8 logical sections: Quick Start, Advanced Cookbook, Components, Tools, Infrastructure, OSS, Utilities, Guides, Release Log
• zh-Hans and English current.json translations complete
• npm run build -- --no-minify passes on both IA (docs: define Docusaurus IA, sidebar structure, and i18n layout #63) and advanced cookbook (docs: write advanced cookbook for production and automation workflows #64) branches

4. i18n Structure ✅

• All new pages have zh-Hans + en copies
• All category.json files mirrored in both locales
• current.json sidebar labels synced for all new categories

5. Firmware Exclusion ✅

• Advanced cookbook: 0 firmware references
• PR Draft: GeneralUpdate.Bowl component documentation #58 (Bowl): correctly states "not firmware recovery"
• PR Draft: GeneralUpdate.Drivelution component documentation #59 (Drivelution): removes two old firmware references
• GeneralUpdate.Firmware not in any sidebar section or new content

6. Build Validation ✅

• main builds: ✅
• IA branch (docs: define Docusaurus IA, sidebar structure, and i18n layout #63): ✅ (fixed beginner cookbook cross-PR dependency)
• Advanced cookbook branch (docs: write advanced cookbook for production and automation workflows #64): ✅

7. Code Snippet Accuracy ✅

• C# examples match current GeneralUpdateBootstrap API
• PowerShell scripts reference actual generate_packages.ps1 and create_versions_json.ps1
• JSON matches src/Server/DTOs/ schema

Open Action Items (non-blocking)

Item	Notes
PR #62 should add quickstart/Beginner cookbook to sidebar	Currently omitted from #63 to avoid cross-PR dependency
Merge order: #56-#62 first, then #63 (IA), then #64 (advanced)	Straightforward merge conflict resolution
onBrokenMarkdownLinks is deprecated in docusaurus.config.js	Cosmetic, migrate in separate PR

Conclusion

No blocking issues found. All documentation is consistent, builds pass, firmware is excluded, and i18n is properly mirrored. Ready to merge after the component/beginner PRs (#56-#62) are reviewed.

[Copilot]

Copilot wasn't able to review any files in this pull request.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[JusterZhu]

Closing: this PR has an empty diff — no changes to review. Consistency review should happen after all other doc PRs land.