docs: document MockMonitor and ClearAllInteractions

Docs/pages/advanced-features/03-monitor-interactions.md

@@ -0,0 +1,35 @@
+# Monitor interactions
+
+Mockolate tracks all interactions with mocks on the mock object. To only track interactions within a given scope, you
+can use a `MockMonitor<T>`:
+
+```csharp
+var sut = Mock.Create<IChocolateDispenser>();
+
+sut.Dispense("Dark", 1); // Not monitored
+var monitorScope = sut.MonitorMock(out var monitor);
+using (monitorScope)
+{
+    sut.Dispense("Dark", 2); // Monitored
+}
+sut.Dispense("Dark", 3); // Not monitored
+
+// Verifications on the monitor only count interactions during the lifetime scope of the `IDisposable`
+monitor.Verify.Invoked.Dispense(It.Is("Dark"), It.IsAny<int>()).Once();
+```
+
+## Clear all interactions
+
+For simpler scenarios you can directly clear all recorded interactions on a mock using `ClearAllInteractions` on the
+setup:
+
+```csharp
+var sut = Mock.Create<IChocolateDispenser>();
+
+sut.Dispense("Dark", 1);
+// Clears all previously recorded interactions
+sut.SetupMock.ClearAllInteractions();
+sut.Dispense("Dark", 2);
+
+sut.VerifyMock.Invoked.Dispense(It.Is("Dark"), It.IsAny<int>()).Once();
+```

Docs/pages/advanced-features/03-check-for-unexpected-interactions.md → Docs/pages/advanced-features/04-check-for-unexpected-interactions.md

@@ -1,6 +1,6 @@
 # Check for unexpected interactions
 
-## ThatAllInteractionsAreVerified
+## That all interactions are verified
 
 You can check if all interactions with the mock have been verified using `ThatAllInteractionsAreVerified`:
 
@@ -12,7 +12,7 @@ bool allVerified = sut.VerifyMock.ThatAllInteractionsAreVerified();
 This is useful for ensuring that your test covers all interactions and that no unexpected calls were made.
 If any interaction was not verified, this method returns `false`.
 
-## ThatAllSetupsAreUsed
+## That all setups are used
 
 You can check if all registered setups on the mock have been used using `ThatAllSetupsAreUsed`:
 

Mockolate.slnx

@@ -51,7 +51,8 @@
   <Folder Name="/_/Docs/advanced-features/">
     <File Path="Docs/pages/advanced-features/01-working-with-protected-members.md" />
     <File Path="Docs/pages/advanced-features/02-advanced-callback-features.md" />
-    <File Path="Docs/pages/advanced-features/03-check-for-unexpected-interactions.md" />
+    <File Path="Docs/pages/advanced-features/03-monitor-interactions.md" />
+    <File Path="Docs/pages/advanced-features/04-check-for-unexpected-interactions.md" />
     <File Path="Docs/pages/advanced-features/_category_.json" />
   </Folder>
   <Folder Name="/_/Docs/setup/">

README.md

@@ -736,9 +736,45 @@ sut.SetupMock.Property.TotalDispensed.OnGet
 	.Do((count, value) => Console.WriteLine($"Read #{count}, value: {value}"));
 ```
 
+### Monitor interactions
+
+Mockolate tracks all interactions with mocks on the mock object. To only track interactions within a given scope, you
+can use a `MockMonitor<T>`:
+
+```csharp
+var sut = Mock.Create<IChocolateDispenser>();
+
+sut.Dispense("Dark", 1); // Not monitored
+var monitorScope = sut.MonitorMock(out var monitor);
+using (monitorScope)
+{
+    sut.Dispense("Dark", 2); // Monitored
+}
+sut.Dispense("Dark", 3); // Not monitored
+
+// Verifications on the monitor only count interactions during the lifetime scope of the `IDisposable`
+monitor.Verify.Invoked.Dispense(It.Is("Dark"), It.IsAny<int>()).Once();
+```
+
+#### Clear all interactions
+
+For simpler scenarios you can directly clear all recorded interactions on a mock using `ClearAllInteractions` on the
+setup:
+
+```csharp
+var sut = Mock.Create<IChocolateDispenser>();
+
+sut.Dispense("Dark", 1);
+// Clears all previously recorded interactions
+sut.SetupMock.ClearAllInteractions();
+sut.Dispense("Dark", 2);
+
+sut.VerifyMock.Invoked.Dispense(It.Is("Dark"), It.IsAny<int>()).Once();
+```
+
 ### Check for unexpected interactions
 
-#### ThatAllInteractionsAreVerified
+#### That all interactions are verified
 
 You can check if all interactions with the mock have been verified using `ThatAllInteractionsAreVerified`:
 
@@ -750,7 +786,7 @@ bool allVerified = sut.VerifyMock.ThatAllInteractionsAreVerified();
 This is useful for ensuring that your test covers all interactions and that no unexpected calls were made.
 If any interaction was not verified, this method returns `false`.
 
-#### ThatAllSetupsAreUsed
+#### That all setups are used
 
 You can check if all registered setups on the mock have been used using `ThatAllSetupsAreUsed`: