commit 955281005f810a7d3df74f0a955a1bf63016de51
Author: Mauro Talevi <mauro.tal...@aquilonia.org>
AuthorDate: Sun, 24 Nov 2013 19:15:24 +0100
Commit: Mauro Talevi <mauro.tal...@aquilonia.org>
CommitDate: Sun, 24 Nov 2013 19:15:24 +0100
JBEHAVE-923: Updated docs.
diff --git a/distribution/src/site/content/given-stories.html
b/distribution/src/site/content/given-stories.html
index cc3e589..fcd7c70 100755
--- a/distribution/src/site/content/given-stories.html
+++ b/distribution/src/site/content/given-stories.html
@@ -48,6 +48,38 @@ be unnecessary and time consuming. For example, for
debugging purposes
one may need to one run one scenario, which may have a dependency on
just one other story. This is where <b>GivenStories</b> is most useful.</p>
+<h3>GivenStories filtered by scenario meta parameters</h3>
+
+<p>At times, it's useful only to depend on one or two scenarios of a story,
and not the entire story.
+In this case, we can use an anchor in the story path to filter the scenarios
that need to be executed.
+The scenarios will be filtered using meta parameters defined in the
scenarios:</p>
+
+<pre class="brush: bdd">
+ GivenStories: path/to/precondition.story#{id1:scenario1;id2:scenario2}
+</pre>
+
+<p>The precondition.story could e.g. contain three scenarios, of which we want
to execute only the first two:</p>
+
+<pre class="brush: bdd">
+
+ Scenario: Scenario 1
+ Meta: @id1 scenario1
+
+ Given ... // scenario executed as a precondition
+
+ Scenario: Scenario 2
+ Meta: @id2 scenario2
+
+ Given ... // scenario executed as a precondition
+
+ Scenario: Scenario 3
+ Meta: @id3 scenario3
+
+ Given ... // scenario not executed as a precondition
+
+</pre>
+
+
<h2>GivenStories parametrized by Examples</h2>
<p>In the spirit of avoid unnecessary duplication, it useful at
