docs: improve documentation

[vbreuss]

This PR enhances and expands the Mockolate documentation by adding comprehensive guides for mock creation, setup, events, and verification. The documentation has been restructured into separate pages and added to the solution file for better organization.

Key changes:

• Updates documentation to reflect the current API (e.g., mock.Setup.Method.MethodName(...) instead of mock.Setup.MethodName(...), mock.Raise instead of mock.Raises)
• Adds detailed examples for methods, properties, indexers, and events
• Expands coverage of argument matchers, async methods, and verification patterns

---

• Fixes Create documentation site #52

[Copilot]

Pull Request Overview

This PR enhances and expands the Mockolate documentation by adding comprehensive guides for mock creation, setup, events, and verification. The documentation has been restructured into separate pages and added to the solution file for better organization.

• Updates documentation to reflect the current API (e.g., mock.Setup.Method.MethodName(...) instead of mock.Setup.MethodName(...), mock.Raise instead of mock.Raises)
• Adds detailed examples for methods, properties, indexers, and events
• Expands coverage of argument matchers, async methods, and verification patterns

Reviewed Changes

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

Show a summary per file

File	Description
Mockolate.sln	Adds a new "Docs" solution folder containing documentation pages
Docs/pages/01-mock-creation.md	Comprehensive guide to creating mocks with constructor parameters, behaviors, and factories
Docs/pages/02-setup.md	Detailed documentation for setting up methods, properties, and indexers with callbacks and matchers
Docs/pages/03-events.md	Updated event raising documentation with corrected API usage (Raise instead of Raises)
Docs/pages/04-verification.md	Expanded verification documentation covering methods, properties, indexers, events, and call ordering

Comments suppressed due to low confidence (1)

Docs/pages/04-verification.md:1

• The en dash character (–) used in the bullet points should be replaced with a standard hyphen (-) for consistency and to avoid potential encoding issues in different text editors and viewers.

# Verify mock interactions

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

Test Results

   11 files  ±0     11 suites  ±0   1m 42s ⏱️ +15s
  918 tests ±0    917 ✅ ±0  1 💤 ±0  0 ❌ ±0 
6 127 runs  ±0  6 126 ✅ ±0  1 💤 ±0  0 ❌ ±0 

Results for commit 5c58992. ± Comparison against base commit 57a070b.

♻️ This comment has been updated with latest results.

[github-actions]

🚀 Benchmark Results

Details

BenchmarkDotNet v0.14.0, Ubuntu 24.04.3 LTS (Noble Numbat)

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

.NET SDK 10.0.100-rc.2.25502.107

[Host] : .NET 10.0.0 (10.0.25.50307), X64 RyuJIT AVX2
Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10

Method	Mean	Error	StdDev	Gen0	Gen1	Allocated
Simple_Mockolate	1.209 μs	0.0167 μs	0.0139 μs	0.1984	-	3.24 KB
Simple_Moq	180.650 μs	0.9367 μs	0.8762 μs	0.4883	-	14.55 KB
Simple_NSubstitute	5.690 μs	0.0403 μs	0.0377 μs	0.5569	0.0076	9.14 KB
Simple_FakeItEasy	6.188 μs	0.0419 μs	0.0371 μs	0.4959	-	8.11 KB

[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.24.0.