refactor: cleanup solution items

[vbreuss]

This pull request updates the documentation structure in the Mockolate.slnx solution file to improve organization and coverage. The most important changes are:

Documentation reorganization and additions:

• Renamed and reordered several main documentation pages, including splitting out the analyzers and comparison sections, and adding new pages for a complete example, benchmarks, and migration guidance.
• Added a new advanced feature page: 06-scenarios.md under Docs/pages/advanced-features/ to cover scenario-based usage.

[Copilot]

Pull request overview

Cleans up the Mockolate.slnx solution file's Docs folder listings so the IDE's solution explorer reflects the current docs structure. Adds entries for newly added documentation pages and renumbers the analyzers/comparison entries to match their renumbered filenames.

Changes:

• Renumbered 07-analyzers.md → 08-analyzers.md and 08-comparison.md → 09-comparison.md to match renamed docs files.
• Added solution entries for new top-level docs: 07-complete-example.md, 10-benchmarks.mdx, 11-migration.md.
• Added advanced-features/06-scenarios.md to the advanced-features folder.

[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]

Test Results

    24 files  ±0      24 suites  ±0   9m 34s ⏱️ +17s
 4 148 tests ±0   4 146 ✅ ±0  2 💤 ±0  0 ❌ ±0 
26 688 runs  ±0  26 684 ✅ ±0  4 💤 ±0  0 ❌ ±0 

Results for commit b9d5cf6. ± Comparison against base commit ca969bc.

[github-actions]

🚀 Benchmark Results

Details

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

AMD EPYC 7763 2.45GHz, 1 CPU, 4 logical and 2 physical cores

.NET SDK 10.0.300

[Host] : .NET 10.0.8 (10.0.8, 10.0.826.23019), X64 RyuJIT x86-64-v3
Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10

CreateMock	Mean	Error	StdDev	Ratio	Allocated	Alloc Ratio
baseline*	67.77 ns	0.790 ns	0.739 ns	0.90	440 B	1.00
Mockolate	75.14 ns	2.767 ns	2.588 ns	1.00	440 B	1.00
Imposter	347.72 ns	5.742 ns	5.090 ns	4.63	2248 B	5.11
TUnitMocks	39.32 ns	0.549 ns	0.514 ns	0.52	192 B	0.44
Moq	1,469.06 ns	8.127 ns	6.786 ns	19.57	2096 B	4.76
NSubstitute	2,113.55 ns	13.082 ns	11.597 ns	28.16	5048 B	11.47
FakeItEasy	2,001.74 ns	27.861 ns	26.062 ns	26.67	2763 B	6.28

Details

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

AMD EPYC 9V74 2.87GHz, 1 CPU, 4 logical and 2 physical cores

.NET SDK 10.0.300

[Host] : .NET 10.0.8 (10.0.8, 10.0.826.23019), X64 RyuJIT x86-64-v3
Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10

Event	Mean	Error	StdDev	Ratio	Allocated	Alloc Ratio
baseline*	314.0 ns	5.27 ns	4.93 ns	1.04	1.78 KB	1.00
Mockolate	301.9 ns	3.67 ns	3.43 ns	1.00	1.78 KB	1.00
Imposter	1,363.4 ns	28.00 ns	26.20 ns	4.52	8.8 KB	4.94
TUnitMocks	176.3 ns	1.44 ns	1.35 ns	0.58	1.34 KB	0.75
Moq	14,297.8 ns	116.17 ns	108.67 ns	47.36	12.51 KB	7.02
NSubstitute	5,424.2 ns	92.45 ns	81.96 ns	17.97	9.05 KB	5.08
FakeItEasy	228,965.1 ns	1,013.35 ns	947.89 ns	758.49	15.26 KB	8.57

Details

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

AMD EPYC 7763 2.45GHz, 1 CPU, 4 logical and 2 physical cores

.NET SDK 10.0.300

[Host] : .NET 10.0.8 (10.0.8, 10.0.826.23019), X64 RyuJIT x86-64-v3
Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10

Indexer	N	Mean	Error	StdDev	Ratio	Allocated	Alloc Ratio
baseline*	1	915.4 ns	10.94 ns	9.70 ns	0.90	3.82 KB	1.00
Mockolate	1	1.019 μs	0.0479 μs	0.0448 μs	1.00	3.82 KB	1.00
Imposter	1	1.019 μs	0.0473 μs	0.0443 μs	1.00	5.16 KB	1.35
Moq	1	225.499 μs	1.1064 μs	1.0349 μs	221.65	20.48 KB	5.36
NSubstitute	1	9.626 μs	0.1096 μs	0.1025 μs	9.46	12.84 KB	3.36
FakeItEasy	1	12.519 μs	0.1082 μs	0.1012 μs	12.31	13.63 KB	3.57
baseline*	10	2,432.7 ns	50.74 ns	47.47 ns	0.93	4.88 KB	1.00
Mockolate	10	2.602 μs	0.0426 μs	0.0398 μs	1.00	4.88 KB	1.00
Imposter	10	2.384 μs	0.0822 μs	0.0769 μs	0.92	7.97 KB	1.63
Moq	10	235.340 μs	2.1208 μs	1.9838 μs	90.46	30 KB	6.15
NSubstitute	10	23.510 μs	0.1394 μs	0.1304 μs	9.04	25.63 KB	5.26
FakeItEasy	10	26.222 μs	0.1098 μs	0.1027 μs	10.08	32.97 KB	6.76

Details

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

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

.NET SDK 10.0.300

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

LaunchCount=1  WarmupCount=10

Method	N	Mean	Error	StdDev	Ratio	Allocated	Alloc Ratio
baseline*	1	365.9 ns	2.90 ns	2.72 ns	0.80	2.04 KB	1.00
Mockolate	1	457.3 ns	5.00 ns	4.68 ns	1.00	2.04 KB	1.00
Imposter	1	724.5 ns	14.83 ns	13.87 ns	1.58	4.04 KB	1.98
TUnitMocks	1	536.6 ns	3.30 ns	3.08 ns	1.17	1.88 KB	0.92
Moq	1	140,455.0 ns	709.77 ns	629.19 ns	307.14	14.74 KB	7.23
NSubstitute	1	6,072.6 ns	26.46 ns	24.75 ns	13.28	9.12 KB	4.47
FakeItEasy	1	6,066.4 ns	34.17 ns	31.96 ns	13.27	8.06 KB	3.95
baseline*	10	636.8 ns	3.37 ns	2.99 ns	0.73	2.25 KB	1.00
Mockolate	10	878.2 ns	3.37 ns	2.99 ns	1.00	2.25 KB	1.00
Imposter	10	1,323.7 ns	20.75 ns	19.41 ns	1.51	5.52 KB	2.45
TUnitMocks	10	1,525.0 ns	4.27 ns	3.99 ns	1.74	3.52 KB	1.57
Moq	10	146,187.7 ns	872.77 ns	816.39 ns	166.46	18.64 KB	8.29
NSubstitute	10	8,848.5 ns	27.72 ns	23.15 ns	10.08	12.07 KB	5.36
FakeItEasy	10	9,683.4 ns	37.41 ns	31.24 ns	11.03	15.42 KB	6.85

Details

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

AMD EPYC 7763 2.45GHz, 1 CPU, 4 logical and 2 physical cores

.NET SDK 10.0.300

[Host] : .NET 10.0.8 (10.0.8, 10.0.826.23019), X64 RyuJIT x86-64-v3
Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10

Property	N	Mean	Error	StdDev	Ratio	Allocated	Alloc Ratio
baseline*	1	516.9 ns	6.22 ns	5.52 ns	1.03	2.47 KB	1.00
Mockolate	1	501.3 ns	17.25 ns	16.13 ns	1.00	2.47 KB	1.00
Imposter	1	454.1 ns	5.18 ns	4.85 ns	0.91	3.13 KB	1.27
TUnitMocks	1	402.9 ns	1.61 ns	1.51 ns	0.80	1.49 KB	0.60
Moq	1	11,556.1 ns	53.68 ns	50.21 ns	23.08	10.39 KB	4.21
NSubstitute	1	7,213.4 ns	40.75 ns	34.03 ns	14.40	11.45 KB	4.64
FakeItEasy	1	7,949.4 ns	31.53 ns	29.49 ns	15.87	11.24 KB	4.55
baseline*	10	1,059.1 ns	16.93 ns	15.84 ns	1.02	2.96 KB	1.00
Mockolate	10	1,034.7 ns	3.01 ns	2.82 ns	1.00	2.96 KB	1.00
Imposter	10	1,236.0 ns	4.63 ns	3.87 ns	1.19	4.67 KB	1.58
TUnitMocks	10	1,389.8 ns	6.34 ns	5.93 ns	1.34	3.65 KB	1.23
Moq	10	18,345.3 ns	76.80 ns	71.84 ns	17.73	18.28 KB	6.17
NSubstitute	10	17,125.6 ns	62.37 ns	48.69 ns	16.55	21.08 KB	7.12
FakeItEasy	10	19,385.2 ns	108.96 ns	96.59 ns	18.74	30.81 KB	10.40

Details

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

AMD EPYC 7763 2.67GHz, 1 CPU, 4 logical and 2 physical cores

.NET SDK 10.0.300

[Host] : .NET 10.0.8 (10.0.8, 10.0.826.23019), X64 RyuJIT x86-64-v3
Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10

Callback	Mean	Error	StdDev	Ratio	Allocated	Alloc Ratio
baseline*	313.6 ns	0.95 ns	0.89 ns	0.88	1.68 KB	1.00
Mockolate	354.4 ns	12.51 ns	11.70 ns	1.00	1.68 KB	1.00
Imposter	429.0 ns	13.14 ns	12.29 ns	1.21	2.38 KB	1.42
TUnitMocks	495.1 ns	10.25 ns	9.09 ns	1.40	1.86 KB	1.11
Moq	100,018.9 ns	507.21 ns	449.63 ns	282.50	8.88 KB	5.29
NSubstitute	4,456.4 ns	53.50 ns	44.68 ns	12.59	7.74 KB	4.61
FakeItEasy	4,711.4 ns	55.27 ns	51.70 ns	13.31	6.81 KB	4.05

baseline* rows show the corresponding Mockolate benchmark from the most recent successful main branch build with results, for regression comparison.