Feature/docs strict build fix upstream dev (FritzAndFriends#563)

* fix: Documentation build issues — add missing nav entries and fix broken links

- Add Migration/InlineCSharp.md to mkdocs.yml nav (was missing from documentation index)
- Fix BWFC022.md reference to ClientScriptMigrationGuide (simplify to direct link)
- Remove TODO image reference in Analyzers.md (bwfc025-warning-squiggle.png not needed for v1.0.0)
- All mkdocs build warnings now cleared in strict mode

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: fix ClientScriptMigrationGuide anchor links for strict build

- Correct BWFC022 cross-file anchor to ClientScriptMigrationGuide heading
- Correct internal anchor link in ClientScriptMigrationGuide
- Keep mkdocs --strict build green in CI

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: csharpfritz

docs/Analyzers/BWFC022.md

@@ -20,6 +20,12 @@ This analyzer warns when your code uses `Page.ClientScript` or `ClientScriptMana
 
 ---
 
+## Recommended Solution
+
+**Use the ClientScriptShim for zero-code rewrite** — See [ClientScript Migration Guide](../Migration/ClientScriptMigrationGuide.md) for details on the easiest migration path that requires no code changes.
+
+---
+
 ## Example
 
 ```csharp
@@ -63,7 +69,7 @@ Page.ClientScript.RegisterStartupScript(GetType(), "init", "...", true);
 ClientScript.RegisterStartupScript(GetType(), "init", "...", true);
 ```
 
-See ["ClientScriptShim (Zero-Rewrite Path)"](../Migration/ClientScriptMigrationGuide.md#-recommended-clientscriptshim-zero-rewrite-path) in the migration guide for details.
+See ["ClientScriptShim (Zero-Rewrite Path)"](../Migration/ClientScriptMigrationGuide.md#recommended-clientscriptshim-zero-rewrite-path) in the migration guide for details.
 
 ---
 

docs/Migration/Analyzers.md

@@ -793,7 +793,6 @@ This analyzer does not have an automatic code fix because the correct replacemen
 
 <!-- TODO: Add Visual Studio screenshot showing BWFC025 Warning squiggle on ViewState assignment with DataTable -->
 <!-- Screenshot should show: the yellow warning squiggle under the assignment, tooltip showing "ViewState assignment stores 'System.Data.DataTable' which may not be JSON-serializable" -->
-![BWFC025 Warning squiggle in Visual Studio](../images/analyzers/bwfc025-warning-squiggle.png){ .analyzer-screenshot }
 
 ---
 

docs/Migration/ClientScriptMigrationGuide.md

@@ -193,7 +193,7 @@ protected override void OnInitialized()
 }
 ```
 
-See [ClientScriptShim (Zero-Rewrite Path)](#-recommended-clientscriptshim-zero-rewrite-path) above for full details.
+See [ClientScriptShim (Zero-Rewrite Path)](#recommended-clientscriptshim-zero-rewrite-path) above for full details.
 
 ### Alternative Approach: Modern IJSRuntime Rewrite
 

mkdocs.yml

@@ -196,46 +196,47 @@ nav:
     - WebFormsPage: UtilityFeatures/WebFormsPage.md
     - WebFormsForm: UtilityFeatures/WebFormsForm.md
   - Migration:
-      - Getting Started: Migration/readme.md
-      - Quick Start Guide: Migration/QuickStart.md
-      - Three-Layer Methodology: Migration/Methodology.md
-      - Control Coverage: Migration/ControlCoverage.md
-      - Strangler Fig Pattern: Migration/StranglerFigPattern.md
-      - Phase 1 - Compilation Shims:
-          - ConfigurationManager: Migration/Phase1-ConfigurationManager.md
-          - App_Start Stubs: Migration/Phase1-AppStartStubs.md
-      - Phase 2 - Runtime Shims:
-          - Session State: Migration/Phase2-SessionShim.md
-          - Page Lifecycle: Migration/Phase2-LifecycleTransforms.md
-          - Event Handler Signatures: Migration/Phase2-EventHandlerSignatures.md
-      - Assess:
-          - Migration Readiness Assessment: Migration/migration_readiness.md
-          - Deprecation Guidance: Migration/DeprecationGuidance.md
-          - Known Fidelity Divergences: MigrationGuides/KnownFidelityDivergences.md
-      - Plan:
-          - Migration Strategies: Migration/Strategies.md
-          - .NET Standard to the Rescue: Migration/NET-Standard.md
-          - Automated Migration Guide: Migration/AutomatedMigration.md
-          - Automated Migration with Copilot: Migration/AutomatedMigrationWithCopilot.md
-          - Roslyn Analyzers: Migration/Analyzers.md
-      - Guides:
-          - ClientScript Migration: Migration/ClientScriptMigrationGuide.md
-      - Implement:
-          - Master Pages: Migration/MasterPages.md
-          - User Controls: Migration/User-Controls.md
-          - Custom Controls: Migration/Custom-Controls.md
-          - Custom Control Base Classes: Migration/CustomControl-BaseClasses.md
-          - Custom WebControl (RenderContents): Migration/CustomWebControl.md
-          - FindControl Migration: Migration/FindControl-Migration.md
-          - Deferred Controls: Migration/DeferredControls.md
-          - Themes and Skins: Migration/ThemesAndSkins.md
-          - Migrating .ashx Handlers: Migration/MigratingAshxHandlers.md
-      - Copilot Skills (AI-Assisted):
-          - Overview: Migration/CopilotSkills/Overview.md
-          - Core Migration: Migration/CopilotSkills/CoreMigration.md
-          - Identity & Auth: Migration/CopilotSkills/IdentityMigration.md
-          - Data & Architecture: Migration/CopilotSkills/DataMigration.md
-      - Migration Checklist Template: Migration/ChecklistTemplate.md
+     - Getting Started: Migration/readme.md
+     - Quick Start Guide: Migration/QuickStart.md
+     - Three-Layer Methodology: Migration/Methodology.md
+     - Control Coverage: Migration/ControlCoverage.md
+     - Strangler Fig Pattern: Migration/StranglerFigPattern.md
+     - Phase 1 - Compilation Shims:
+         - ConfigurationManager: Migration/Phase1-ConfigurationManager.md
+         - App_Start Stubs: Migration/Phase1-AppStartStubs.md
+     - Phase 2 - Runtime Shims:
+         - Session State: Migration/Phase2-SessionShim.md
+         - Page Lifecycle: Migration/Phase2-LifecycleTransforms.md
+         - Event Handler Signatures: Migration/Phase2-EventHandlerSignatures.md
+     - Assess:
+         - Migration Readiness Assessment: Migration/migration_readiness.md
+         - Deprecation Guidance: Migration/DeprecationGuidance.md
+         - Known Fidelity Divergences: MigrationGuides/KnownFidelityDivergences.md
+     - Plan:
+         - Migration Strategies: Migration/Strategies.md
+         - .NET Standard to the Rescue: Migration/NET-Standard.md
+         - Automated Migration Guide: Migration/AutomatedMigration.md
+         - Automated Migration with Copilot: Migration/AutomatedMigrationWithCopilot.md
+         - Roslyn Analyzers: Migration/Analyzers.md
+     - Guides:
+         - ClientScript Migration: Migration/ClientScriptMigrationGuide.md
+         - Inline C# Forms: Migration/InlineCSharp.md
+     - Implement:
+         - Master Pages: Migration/MasterPages.md
+         - User Controls: Migration/User-Controls.md
+         - Custom Controls: Migration/Custom-Controls.md
+         - Custom Control Base Classes: Migration/CustomControl-BaseClasses.md
+         - Custom WebControl (RenderContents): Migration/CustomWebControl.md
+         - FindControl Migration: Migration/FindControl-Migration.md
+         - Deferred Controls: Migration/DeferredControls.md
+         - Themes and Skins: Migration/ThemesAndSkins.md
+         - Migrating .ashx Handlers: Migration/MigratingAshxHandlers.md
+     - Copilot Skills (AI-Assisted):
+         - Overview: Migration/CopilotSkills/Overview.md
+         - Core Migration: Migration/CopilotSkills/CoreMigration.md
+         - Identity & Auth: Migration/CopilotSkills/IdentityMigration.md
+         - Data & Architecture: Migration/CopilotSkills/DataMigration.md
+     - Migration Checklist Template: Migration/ChecklistTemplate.md
   - Analyzers:
       - BWFC022: Analyzers/BWFC022.md
       - BWFC023: Analyzers/BWFC023.md