docs: document repeating callback invocations (For)

[vbreuss]

This PR adds documentation for the For method, which controls how many times a callback should be repeated. The documentation also reorganizes existing callback control features with clearer headings and examples.

Changes:

• Added new section documenting the For method for repeating callbacks a specific number of times
• Reorganized callback control documentation with clearer section titles (When, Only, For)
• Added Forever subsection explaining indefinite repetition for sequences

[Copilot]

Pull request overview

This PR adds documentation for the For method, which controls how many times a callback should be repeated. The documentation also reorganizes existing callback control features with clearer headings and examples.

Changes:

• Added new section documenting the For method for repeating callbacks a specific number of times
• Reorganized callback control documentation with clearer section titles (When, Only, For)
• Added Forever subsection explaining indefinite repetition for sequences

Reviewed changes

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

File	Description
README.md	Added For method documentation and reorganized callback control sections with clearer headings
Docs/pages/advanced-features/02-advanced-callback-features.md	Added For method documentation and reorganized callback control sections with clearer headings

[github-actions]

🚀 Benchmark Results

Details

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

AMD EPYC 7763 2.78GHz, 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.605 μs	0.0224 μs	0.0210 μs	0.2270	-	3.73 KB
Simple_Moq	178.937 μs	1.7290 μs	1.6173 μs	0.4883	-	14.55 KB
Simple_NSubstitute	5.803 μs	0.0482 μs	0.0451 μs	0.5569	0.0076	9.14 KB
Simple_FakeItEasy	6.752 μs	0.0502 μs	0.0445 μs	0.4959	-	8.11 KB

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 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]

Test Results

    21 files  ±0      21 suites  ±0   6m 1s ⏱️ +46s
 2 518 tests ±0   2 517 ✅ ±0  1 💤 ±0  0 ❌ ±0 
16 807 runs  ±0  16 806 ✅ ±0  1 💤 ±0  0 ❌ ±0 

Results for commit 656bd3b. ± Comparison against base commit f6e2ebe.

[github-actions]

This is addressed in release v1.2.0.