Canonicalise permitting GIVEN with the SCENARIO

It looks nicer for short scenarios.

1 files changed, 14 insertions, 0 deletions

diff --git a/TESTING b/TESTING
index 8c754c7..6253086 100644
--- a/TESTING
+++ b/TESTING
@@ -209,6 +209,20 @@ For the sake of readability, this codebase also has the following rules:
     that requires cleaning up,
     this often reads strangely and causes unnecessary padding.
 
+7.  In non-story scenarios
+    the `GIVEN` may be part of the `SCENARIO` and `ASSUMING` block.
+
+    There's two rough classifications of scenarios:
+
+    1.  Those that set up one thing (one `GIVEN` block) and test that,
+        somewhat like unit tests.
+    2.  Those that set things up multiple times (many `GIVEN` blocks)
+        and test each of those, structured as a story.
+
+    In the non-story scenarios there will be only one `GIVEN` block,
+    so it may be more aesthetically pleasing to group it with the
+    `SCENARIO` and `ASSUMING`s which also only happen once, at the start.
+
 Tip and tricks when writing tests for Gitano
 ============================================