Documentation Overhaul – Cookbook, parity table, real-world examples

[cwinland]

Milestone 7 – Documentation & Real-World Scenarios

Goal:
Deliver comprehensive, actionable documentation and sample applications that demonstrate FastMoq’s capabilities across real-world .NET and Azure use cases. This milestone supports onboarding, adoption, and developer confidence by showing how FastMoq simplifies mocking in complex environments.

---

Key Deliverables

• Getting Started Guide

  • Clear setup instructions and first test walkthrough
  • Explanation of provider architecture and fluent syntax

• Feature Parity Table

  • Side-by-side comparison of FastMoq vs Moq/NSubstitute
  • Highlight auto-injection, fluent scenarios, and extensibility

• Cookbook Recipes

  • Common mocking patterns (e.g., API controllers, EF Core, background services)
  • Fluent scenario examples with verification and logging

• Sample App

  • Real-world .NET application with FastMoq-based tests
  • Includes Azure-focused modules (e.g., Storage, Queue, Auth setup)
  • Demonstrates how to mock Azure SDKs and services despite limited interfaces
  • Covers test setup for IOptions<T>, ILogger<T>, IConfiguration, and other DI patterns

• Time-Saving Comparisons

  • Benchmarks or side-by-side test examples showing reduced boilerplate
  • Developer productivity highlights

---

Outcome:
FastMoq becomes easier to adopt and trust, with clear guidance and examples tailored to modern .NET and Azure development workflows.