Doc rewrites

Author: cwinland

README.md

@@ -124,7 +124,7 @@ If you want a copy-paste example that works under the default provider without M
 - **🧪 [Testing Guide](./docs/getting-started/testing-guide.md)** - Repo-native guidance for `GetOrCreateMock<T>()`, `AddType(...)`, `DbContext`, `IFileSystem`, and known types
 - **🔄 [Migration Guide](./docs/migration)** - Practical old-to-new guidance for the `3.0.0` to `4.3.0` transition
 - **👨‍🍳 [Cookbook](./docs/cookbook)** - Real-world patterns and recipes with compatibility-only pockets labeled explicitly
-- **🔎 [API Reference Overview](./docs/api/index.md)** - Example-first API entry points plus quick routes into the generated reference
+- **🔎 [API Reference](https://help.fastmoq.com/)** - Published HTML API reference for namespaces, types, and members
 - **🌐 [Web Helper Guidance](./docs/getting-started/testing-guide.md#controller-testing)** - Controller, `HttpContext`, `IHttpContextAccessor`, and claims-principal test setup
 - **🔌 [Provider Selection Guide](./docs/getting-started/provider-selection.md)** - How to register, select, and bootstrap providers for a test assembly
 - **📋 [Provider Capabilities](./docs/getting-started/provider-capabilities.md)** - What `moq`, `nsubstitute`, and `reflection` support today, with recommended usage patterns

docs/README.md

@@ -53,7 +53,7 @@ Practical guidance for moving from the public `3.0.0` release toward the current
 
 ### 🔎 [API Reference](./api/index.md)
 
-Use the docs-side API overview when you want example-first entry points before dropping into the generated YAML pages.
+Use the docs-side API overview when you want example-first entry points and curated type routes. Use [Complete API Documentation](https://help.fastmoq.com/) when you want the full published namespace, type, and member reference.
 
 - Example-first API routes
 - Quick reference for common types

docs/api/index.md

@@ -1,6 +1,6 @@
 # FastMoq API Reference
 
-This API reference is generated from XML comments in the source projects.
+The published API reference is generated from XML comments in the source projects.
 
 ## Example-first entry points
 
@@ -13,18 +13,18 @@ This API reference is generated from XML comments in the source projects.
 ## Quick type lookup
 
 - [Quick reference for common types](./quick-reference.md)
-- [Mocker](../../api/FastMoq.Mocker.yml)
-- [MockerTestBase<TComponent>](../../api/FastMoq.MockerTestBase-1.yml)
-- [ScenarioBuilder<T>](../../api/FastMoq.ScenarioBuilder-1.yml)
-- [IFastMock<T>](../../api/FastMoq.Providers.IFastMock-1.yml)
-- [MockModel<T>](../../api/FastMoq.Models.MockModel-1.yml)
-- [MockingProviderRegistry](../../api/FastMoq.Providers.MockingProviderRegistry.yml)
-- [FunctionContextTestExtensions](../../api/FastMoq.AzureFunctions.Extensions.FunctionContextTestExtensions.yml)
-- [TestWebExtensions](../../api/FastMoq.Web.Extensions.TestWebExtensions.yml)
+- [Mocker](https://help.fastmoq.com/api/FastMoq.Mocker.html)
+- [MockerTestBase<TComponent>](https://help.fastmoq.com/api/FastMoq.MockerTestBase-1.html)
+- [ScenarioBuilder<T>](https://help.fastmoq.com/api/FastMoq.ScenarioBuilder-1.html)
+- [IFastMock<T>](https://help.fastmoq.com/api/FastMoq.Providers.IFastMock-1.html)
+- [MockModel<T>](https://help.fastmoq.com/api/FastMoq.Models.MockModel-1.html)
+- [MockingProviderRegistry](https://help.fastmoq.com/api/FastMoq.Providers.MockingProviderRegistry.html)
+- [FunctionContextTestExtensions](https://help.fastmoq.com/api/FastMoq.AzureFunctions.Extensions.FunctionContextTestExtensions.html)
+- [TestWebExtensions](https://help.fastmoq.com/api/FastMoq.Web.Extensions.TestWebExtensions.html)
 
 If you are integrating a non-bundled mocking library, start from [Quick reference for common types](./quick-reference.md) and follow the provider path through `IMockingProvider`, `IMockingProviderCapabilities`, and `MockingProviderRegistry`.
 
-Lifecycle note: tracked creation helpers such as `GetOrCreateMock<T>()` and `CreateFastMock<T>()`, plus detached creation through `CreateStandaloneFastMock<T>()`, are methods on [Mocker](../../api/FastMoq.Mocker.yml) rather than separate API types.
+Lifecycle note: tracked creation helpers such as `GetOrCreateMock<T>()` and `CreateFastMock<T>()`, plus detached creation through `CreateStandaloneFastMock<T>()`, are methods on [Mocker](https://help.fastmoq.com/api/FastMoq.Mocker.html) rather than separate API types.
 
 ## Notes
 

docs/api/quick-reference.md

@@ -4,101 +4,101 @@ Use this page when you already know the type name and want to jump straight to t
 
 ## Most-used starting points
 
-- [Mocker](../../api/FastMoq.Mocker.yml)
-- [MockerTestBase<TComponent>](../../api/FastMoq.MockerTestBase-1.yml)
-- [ScenarioBuilder<T>](../../api/FastMoq.ScenarioBuilder-1.yml)
-- [MockingProviderRegistry](../../api/FastMoq.Providers.MockingProviderRegistry.yml)
-- [MockerBlazorTestBase<T>](../../api/FastMoq.Web.Blazor.MockerBlazorTestBase-1.yml)
+- [Mocker](https://help.fastmoq.com/api/FastMoq.Mocker.html)
+- [MockerTestBase<TComponent>](https://help.fastmoq.com/api/FastMoq.MockerTestBase-1.html)
+- [ScenarioBuilder<T>](https://help.fastmoq.com/api/FastMoq.ScenarioBuilder-1.html)
+- [MockingProviderRegistry](https://help.fastmoq.com/api/FastMoq.Providers.MockingProviderRegistry.html)
+- [MockerBlazorTestBase<T>](https://help.fastmoq.com/api/FastMoq.Web.Blazor.MockerBlazorTestBase-1.html)
 
 ## Core test entry points
 
-- [Mocker](../../api/FastMoq.Mocker.yml)
-- [MockerTestBase<TComponent>](../../api/FastMoq.MockerTestBase-1.yml)
-- [ScenarioBuilder<T>](../../api/FastMoq.ScenarioBuilder-1.yml)
+- [Mocker](https://help.fastmoq.com/api/FastMoq.Mocker.html)
+- [MockerTestBase<TComponent>](https://help.fastmoq.com/api/FastMoq.MockerTestBase-1.html)
+- [ScenarioBuilder<T>](https://help.fastmoq.com/api/FastMoq.ScenarioBuilder-1.html)
 
 ## Arrange and creation
 
-- [Mocker](../../api/FastMoq.Mocker.yml)
-- [IFastMock<T>](../../api/FastMoq.Providers.IFastMock-1.yml)
-- [KnownTypeRegistration](../../api/FastMoq.KnownTypeRegistration.yml)
-- [InstanceCreationFlags](../../api/FastMoq.InstanceCreationFlags.yml)
-- [InvocationOptions](../../api/FastMoq.InvocationOptions.yml)
+- [Mocker](https://help.fastmoq.com/api/FastMoq.Mocker.html)
+- [IFastMock<T>](https://help.fastmoq.com/api/FastMoq.Providers.IFastMock-1.html)
+- [KnownTypeRegistration](https://help.fastmoq.com/api/FastMoq.KnownTypeRegistration.html)
+- [InstanceCreationFlags](https://help.fastmoq.com/api/FastMoq.InstanceCreationFlags.html)
+- [InvocationOptions](https://help.fastmoq.com/api/FastMoq.InvocationOptions.html)
 
-Use the [Mocker](../../api/FastMoq.Mocker.yml) page for the tracked and standalone creation APIs: `GetOrCreateMock<T>()`, `CreateFastMock<T>()`, and `CreateStandaloneFastMock<T>()`.
+Use the [Mocker](https://help.fastmoq.com/api/FastMoq.Mocker.html) page for the tracked and standalone creation APIs: `GetOrCreateMock<T>()`, `CreateFastMock<T>()`, and `CreateStandaloneFastMock<T>()`.
 
 ## Provider APIs
 
-- [MockingProviderRegistry](../../api/FastMoq.Providers.MockingProviderRegistry.yml)
-- [IMockingProvider](../../api/FastMoq.Providers.IMockingProvider.yml)
-- [IMockingProviderCapabilities](../../api/FastMoq.Providers.IMockingProviderCapabilities.yml)
-- [TimesSpec](../../api/FastMoq.Providers.TimesSpec.yml)
-- [MockCreationOptions](../../api/FastMoq.Providers.MockCreationOptions.yml)
+- [MockingProviderRegistry](https://help.fastmoq.com/api/FastMoq.Providers.MockingProviderRegistry.html)
+- [IMockingProvider](https://help.fastmoq.com/api/FastMoq.Providers.IMockingProvider.html)
+- [IMockingProviderCapabilities](https://help.fastmoq.com/api/FastMoq.Providers.IMockingProviderCapabilities.html)
+- [TimesSpec](https://help.fastmoq.com/api/FastMoq.Providers.TimesSpec.html)
+- [MockCreationOptions](https://help.fastmoq.com/api/FastMoq.Providers.MockCreationOptions.html)
 
-If you are writing your own provider instead of using the bundled ones, start with [IMockingProvider](../../api/FastMoq.Providers.IMockingProvider.yml), then [IMockingProviderCapabilities](../../api/FastMoq.Providers.IMockingProviderCapabilities.yml), then [MockingProviderRegistry](../../api/FastMoq.Providers.MockingProviderRegistry.yml).
+If you are writing your own provider instead of using the bundled ones, start with [IMockingProvider](https://help.fastmoq.com/api/FastMoq.Providers.IMockingProvider.html), then [IMockingProviderCapabilities](https://help.fastmoq.com/api/FastMoq.Providers.IMockingProviderCapabilities.html), then [MockingProviderRegistry](https://help.fastmoq.com/api/FastMoq.Providers.MockingProviderRegistry.html).
 
-Detached provider-first creation and verification also live on [MockingProviderRegistry](../../api/FastMoq.Providers.MockingProviderRegistry.yml): use `CreateMock<T>()`, `Verify(...)`, and `VerifyNoOtherCalls(...)` there when the `IFastMock<T>` handle is not tracked inside a `Mocker`.
+Detached provider-first creation and verification also live on [MockingProviderRegistry](https://help.fastmoq.com/api/FastMoq.Providers.MockingProviderRegistry.html): use `CreateMock<T>()`, `Verify(...)`, and `VerifyNoOtherCalls(...)` there when the `IFastMock<T>` handle is not tracked inside a `Mocker`.
 
 Reflection-provider reminder: its verification is best-effort and only compares direct constant arguments with `Equals(...)`; it is not equivalent to richer provider-native matcher semantics.
 
 ## Logging and verification
 
-- [TestClassExtensions](../../api/FastMoq.Extensions.TestClassExtensions.yml)
-- [TimesSpec](../../api/FastMoq.Providers.TimesSpec.yml)
-- [MockBehaviorOptions](../../api/FastMoq.MockBehaviorOptions.yml)
-- [MockFeatures](../../api/FastMoq.MockFeatures.yml)
+- [TestClassExtensions](https://help.fastmoq.com/api/FastMoq.Extensions.TestClassExtensions.html)
+- [TimesSpec](https://help.fastmoq.com/api/FastMoq.Providers.TimesSpec.html)
+- [MockBehaviorOptions](https://help.fastmoq.com/api/FastMoq.MockBehaviorOptions.html)
+- [MockFeatures](https://help.fastmoq.com/api/FastMoq.MockFeatures.html)
 
 ## Extension helpers
 
-- [MockerCreationExtensions](../../api/FastMoq.Extensions.MockerCreationExtensions.yml)
-- [TestClassExtensions](../../api/FastMoq.Extensions.TestClassExtensions.yml)
-- [MockerHttpExtensions](../../api/FastMoq.Extensions.MockerHttpExtensions.yml)
-- [MockerBooleanExtensions](../../api/FastMoq.Extensions.MockerBooleanExtensions.yml)
-- [ObjectExtensions](../../api/FastMoq.Extensions.ObjectExtensions.yml)
+- [MockerCreationExtensions](https://help.fastmoq.com/api/FastMoq.Extensions.MockerCreationExtensions.html)
+- [TestClassExtensions](https://help.fastmoq.com/api/FastMoq.Extensions.TestClassExtensions.html)
+- [MockerHttpExtensions](https://help.fastmoq.com/api/FastMoq.Extensions.MockerHttpExtensions.html)
+- [MockerBooleanExtensions](https://help.fastmoq.com/api/FastMoq.Extensions.MockerBooleanExtensions.html)
+- [ObjectExtensions](https://help.fastmoq.com/api/FastMoq.Extensions.ObjectExtensions.html)
 
 ## Framework helpers
 
-- [FunctionContextTestExtensions](../../api/FastMoq.AzureFunctions.Extensions.FunctionContextTestExtensions.yml)
-- [TestWebExtensions](../../api/FastMoq.Web.Extensions.TestWebExtensions.yml)
+- [FunctionContextTestExtensions](https://help.fastmoq.com/api/FastMoq.AzureFunctions.Extensions.FunctionContextTestExtensions.html)
+- [TestWebExtensions](https://help.fastmoq.com/api/FastMoq.Web.Extensions.TestWebExtensions.html)
 
 ## Database helpers
 
-- [DbContextMockerExtensions](../../api/FastMoq.DbContextMockerExtensions.yml)
-- [DbContextHandle&lt;TContext&gt;](../../api/FastMoq.DbContextHandle-1.yml)
-- [DbContextHandleOptions&lt;TContext&gt;](../../api/FastMoq.DbContextHandleOptions-1.yml)
-- [DbContextTestMode](../../api/FastMoq.DbContextTestMode.yml)
+- [DbContextMockerExtensions](https://help.fastmoq.com/api/FastMoq.DbContextMockerExtensions.html)
+- [DbContextHandle&lt;TContext&gt;](https://help.fastmoq.com/api/FastMoq.DbContextHandle-1.html)
+- [DbContextHandleOptions&lt;TContext&gt;](https://help.fastmoq.com/api/FastMoq.DbContextHandleOptions-1.html)
+- [DbContextTestMode](https://help.fastmoq.com/api/FastMoq.DbContextTestMode.html)
 
 ## Common models and helper types
 
-- [LogEntry](../../api/FastMoq.Models.LogEntry.yml)
-- [MockModel&lt;T&gt;](../../api/FastMoq.Models.MockModel-1.yml)
-- [InstanceModel&lt;TClass&gt;](../../api/FastMoq.Models.InstanceModel-1.yml)
-- [ConstructorHistory](../../api/FastMoq.Models.ConstructorHistory.yml)
+- [LogEntry](https://help.fastmoq.com/api/FastMoq.Models.LogEntry.html)
+- [MockModel&lt;T&gt;](https://help.fastmoq.com/api/FastMoq.Models.MockModel-1.html)
+- [InstanceModel&lt;TClass&gt;](https://help.fastmoq.com/api/FastMoq.Models.InstanceModel-1.html)
+- [ConstructorHistory](https://help.fastmoq.com/api/FastMoq.Models.ConstructorHistory.html)
 
 ## Tracked models and provider escape hatches
 
-- [IFastMock&lt;T&gt;](../../api/FastMoq.Providers.IFastMock-1.yml)
-- [MockModel&lt;T&gt;](../../api/FastMoq.Models.MockModel-1.yml)
-- [MockingProviderRegistry](../../api/FastMoq.Providers.MockingProviderRegistry.yml)
+- [IFastMock&lt;T&gt;](https://help.fastmoq.com/api/FastMoq.Providers.IFastMock-1.html)
+- [MockModel&lt;T&gt;](https://help.fastmoq.com/api/FastMoq.Models.MockModel-1.html)
+- [MockingProviderRegistry](https://help.fastmoq.com/api/FastMoq.Providers.MockingProviderRegistry.html)
 
 `MockModel` equality is type-based, not instance-based. Use it to reason about mocked service types, not to decide whether two provider-native doubles are the same object.
 
 ## Blazor and web
 
-- [MockerBlazorTestBase&lt;T&gt;](../../api/FastMoq.Web.Blazor.MockerBlazorTestBase-1.yml)
-- [IMockerBlazorTestHelpers&lt;T&gt;](../../api/FastMoq.Web.Blazor.Interfaces.IMockerBlazorTestHelpers-1.yml)
-- [ComponentState&lt;T&gt;](../../api/FastMoq.Web.Blazor.Models.ComponentState-1.yml)
+- [MockerBlazorTestBase&lt;T&gt;](https://help.fastmoq.com/api/FastMoq.Web.Blazor.MockerBlazorTestBase-1.html)
+- [IMockerBlazorTestHelpers&lt;T&gt;](https://help.fastmoq.com/api/FastMoq.Web.Blazor.Interfaces.IMockerBlazorTestHelpers-1.html)
+- [ComponentState&lt;T&gt;](https://help.fastmoq.com/api/FastMoq.Web.Blazor.Models.ComponentState-1.html)
 
 ## Fast ways to find a type
 
 - Use the search box in the top-right and search for the exact type name, such as `Mocker` or `MockerTestBase`.
-- Use the site navigation to jump into [Core namespace](../../api/FastMoq.yml) when you know the type is in the main FastMoq namespace.
+- Use the site navigation to jump into [Core namespace](https://help.fastmoq.com/api/FastMoq.html) when you know the type is in the main FastMoq namespace.
 - Use [API overview](./index.md) when you want package-level entry points before drilling into a type.
 
 ## Typical navigation paths
 
-- Starting a new service test: [MockerTestBase&lt;TComponent&gt;](../../api/FastMoq.MockerTestBase-1.yml) then [Mocker](../../api/FastMoq.Mocker.yml)
-- Configuring provider behavior: [MockingProviderRegistry](../../api/FastMoq.Providers.MockingProviderRegistry.yml) then [IMockingProvider](../../api/FastMoq.Providers.IMockingProvider.yml)
-- Writing a custom provider: [IMockingProvider](../../api/FastMoq.Providers.IMockingProvider.yml) then [IMockingProviderCapabilities](../../api/FastMoq.Providers.IMockingProviderCapabilities.yml) then [MockingProviderRegistry](../../api/FastMoq.Providers.MockingProviderRegistry.yml)
-- Verifying interactions: [TimesSpec](../../api/FastMoq.Providers.TimesSpec.yml) then [TestClassExtensions](../../api/FastMoq.Extensions.TestClassExtensions.yml)
-- Wiring Azure Functions worker tests: [FunctionContextTestExtensions](../../api/FastMoq.AzureFunctions.Extensions.FunctionContextTestExtensions.yml) then [Mocker](../../api/FastMoq.Mocker.yml)
-- Working with Blazor components: [MockerBlazorTestBase&lt;T&gt;](../../api/FastMoq.Web.Blazor.MockerBlazorTestBase-1.yml) then [IMockerBlazorTestHelpers&lt;T&gt;](../../api/FastMoq.Web.Blazor.Interfaces.IMockerBlazorTestHelpers-1.yml)
+- Starting a new service test: [MockerTestBase&lt;TComponent&gt;](https://help.fastmoq.com/api/FastMoq.MockerTestBase-1.html) then [Mocker](https://help.fastmoq.com/api/FastMoq.Mocker.html)
+- Configuring provider behavior: [MockingProviderRegistry](https://help.fastmoq.com/api/FastMoq.Providers.MockingProviderRegistry.html) then [IMockingProvider](https://help.fastmoq.com/api/FastMoq.Providers.IMockingProvider.html)
+- Writing a custom provider: [IMockingProvider](https://help.fastmoq.com/api/FastMoq.Providers.IMockingProvider.html) then [IMockingProviderCapabilities](https://help.fastmoq.com/api/FastMoq.Providers.IMockingProviderCapabilities.html) then [MockingProviderRegistry](https://help.fastmoq.com/api/FastMoq.Providers.MockingProviderRegistry.html)
+- Verifying interactions: [TimesSpec](https://help.fastmoq.com/api/FastMoq.Providers.TimesSpec.html) then [TestClassExtensions](https://help.fastmoq.com/api/FastMoq.Extensions.TestClassExtensions.html)
+- Wiring Azure Functions worker tests: [FunctionContextTestExtensions](https://help.fastmoq.com/api/FastMoq.AzureFunctions.Extensions.FunctionContextTestExtensions.html) then [Mocker](https://help.fastmoq.com/api/FastMoq.Mocker.html)
+- Working with Blazor components: [MockerBlazorTestBase&lt;T&gt;](https://help.fastmoq.com/api/FastMoq.Web.Blazor.MockerBlazorTestBase-1.html) then [IMockerBlazorTestHelpers&lt;T&gt;](https://help.fastmoq.com/api/FastMoq.Web.Blazor.Interfaces.IMockerBlazorTestHelpers-1.html)