docs: improve documentation

[vbreuss]

This PR improves the documentation by reorganizing code examples and expanding configuration details. The changes make the documentation clearer and more comprehensive by moving interface definitions to the top of examples and adding missing information about mock configuration options.

Key changes:

• Moved interface/delegate definitions to the beginning of code examples for better readability
• Corrected reference from factory.Create to Mock.Create for consistency
• Added documentation for the Initialize<T> configuration option and expanded details on DefaultValue behavior

---

• Fixes Docs: Mock Behavior Options Incomplete #329
• Fixes Docs: add use cases for Mock.Factory #330

[github-actions]

Test Results

    14 files  ±0      14 suites  ±0   5m 37s ⏱️ +51s
 1 781 tests ±0   1 780 ✅ ±0  1 💤 ±0  0 ❌ ±0 
11 924 runs  ±0  11 923 ✅ ±0  1 💤 ±0  0 ❌ ±0 

Results for commit 7dde8e1. ± Comparison against base commit 8e21298.

♻️ This comment has been updated with latest results.

[github-actions]

🚀 Benchmark Results

Details

BenchmarkDotNet v0.15.8, Linux Ubuntu 24.04.3 LTS (Noble Numbat)

Intel Xeon Platinum 8370C CPU 2.80GHz, 1 CPU, 4 logical and 2 physical cores

.NET SDK 10.0.101

[Host] : .NET 10.0.1 (10.0.1, 10.0.125.57005), X64 RyuJIT x86-64-v4
Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10

Method	Mean	Error	StdDev	Gen0	Gen1	Allocated
Simple_Mockolate	1.569 μs	0.0064 μs	0.0054 μs	0.1488	-	3.66 KB
Simple_Moq	138.146 μs	0.4139 μs	0.3669 μs	0.4883	0.2441	14.56 KB
Simple_NSubstitute	5.993 μs	0.0202 μs	0.0189 μs	0.3662	-	9.14 KB
Simple_FakeItEasy	6.328 μs	0.0224 μs	0.0209 μs	0.3281	-	8.12 KB

[Copilot]

Pull request overview

This PR improves the documentation by reorganizing code examples and expanding configuration details. The changes make the documentation clearer and more comprehensive by moving interface definitions to the top of examples and adding missing information about mock configuration options.

• Moved interface/delegate definitions to the beginning of code examples for better readability
• Corrected reference from factory.Create to Mock.Create for consistency
• Added documentation for the Initialize<T> configuration option and expanded details on DefaultValue behavior

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
README.md	Reorganized example code to show interface definitions first, fixed incorrect API reference, and added documentation for Initialize and DefaultValue configuration options
Docs/pages/01-create-mocks.md	Fixed incorrect API reference and added documentation for Initialize and DefaultValue configuration options
Docs/pages/00-index.md	Reorganized example code to show interface definitions first

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[github-actions]

This is addressed in release v0.46.0.