Updated Scenarios and States (markdown)

Scenarios-and-States.md

@@ -1,11 +1,11 @@
-# Scenarios
+# Using Scenarios
 
-WireMock.Net supports state via the notion of scenarios. A scenario is essentially a state machine whose states can be arbitrarily assigned. Stub mappings can be configured to match on scenario state, such that stub A can be returned initially, then stub B once the next scenario state has been triggered.
+WireMock.Net supports _State_ via the notion of _scenarios_. A scenario is essentially a state machine whose states can be arbitrarily assigned. Stub mappings can be configured to match on scenario state, such that stub A can be returned initially, then stub B once the next scenario state has been triggered.
 
 For example, suppose we’re writing a to-do list application consisting of a rich client of some kind talking to a REST service. We want to test that our UI can read the to-do list, add an item and refresh itself, showing the updated list.
 
 Example test code:
-```c#
+``` c#
 // Assign
 _server = WireMockServer.Start();
 
@@ -66,3 +66,25 @@ The first Scenario and State definition can also be used in the JSON Admin inter
     }
 }
 ```
+
+# Stay in the same State for a number of requests
+In case you want to match a request for a certain state multiple times before moving to the next state, you can specify this. Example code:
+
+In the above scenario, if you want to add more items to the ToDo list, like 
+- Fixing the car
+- Cancel newspaper
+
+And you want to move to the next state when these two requests are matched, set the `times` variable to `2` like this:
+
+
+``` c#
+_server
+  .Given(Request.Create()
+    .WithPath("/todo/items")
+    .UsingPost())
+  .InScenario("To do list")
+  .WhenStateIs("TodoList State Started")
+  .WillSetStateTo("Cancel newspaper item added", 2) // <-- The number of times this match should be matched before the state will be changed to the specified one.
+  .RespondWith(Response.Create()
+    .WithStatusCode(201));
+```