docs: improve documentation

[vbreuss]

This PR improves documentation clarity and consistency across README.md and the create-mocks documentation page by reorganizing content, clarifying explanations, and fixing examples.

Key Changes:

• Reorganized MockBehavior options documentation to improve readability
• Updated code examples to use MockBehavior.Default with { ... } syntax instead of new MockBehavior { ... }
• Added clarifying notes about wrapping instances and additional interfaces

[github-actions]

Test Results

    21 files  ±0      21 suites  ±0   5m 37s ⏱️ +3s
 2 508 tests ±0   2 507 ✅ ±0  1 💤 ±0  0 ❌ ±0 
16 835 runs  ±0  16 834 ✅ ±0  1 💤 ±0  0 ❌ ±0 

Results for commit e1cbe0b. ± Comparison against base commit 2097b4d.

♻️ 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)

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

.NET SDK 10.0.102

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

LaunchCount=1  WarmupCount=10

Method	Mean	Error	StdDev	Gen0	Gen1	Allocated
Simple_Mockolate	1.539 μs	0.0202 μs	0.0179 μs	0.2270	-	3.73 KB
Simple_Moq	176.112 μs	0.8483 μs	0.7520 μs	0.4883	-	14.55 KB
Simple_NSubstitute	5.642 μs	0.0774 μs	0.0686 μs	0.5569	0.0076	9.14 KB
Simple_FakeItEasy	6.582 μs	0.0445 μs	0.0416 μs	0.4959	-	8.11 KB

[Copilot]

Pull request overview

This PR improves documentation clarity and consistency across README.md and the create-mocks documentation page by reorganizing content, clarifying explanations, and fixing examples.

Changes:

• Reorganized MockBehavior options documentation to improve readability
• Updated code examples to use MockBehavior.Default with { ... } syntax instead of new MockBehavior { ... }
• Added clarifying notes about wrapping instances and additional interfaces

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
README.md	Reorganized MockBehavior options, updated examples to use with syntax, added clarifications for mocking multiple interfaces and wrapping instances
Docs/pages/01-create-mocks.md	Applied identical documentation improvements as README.md for consistency

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

[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 v1.2.0.