slightly clearer documentation

distribution/src/site/content/examples-modules.html

@@ -24,7 +24,7 @@ <h2>Example Modules</h2>
 <li>noughtsandcrosses: verifies GUI behaviours</li>
 <li>spring-security: verifies Spring-based security behaviours</li>
 <li>performance: verifies performance behaviour</li>
-<li>threads: verifies multi-threading behaviour</li>
+<li><a href="https://github.com/jbehave/jbehave-core/tree/master/examples/threads">threads</a>: verifies multi-threading behaviour</li>
 <li>trader:  contains stories verifying the behaviour of multiple functionalities of JBehave</li>
 <li>trader-ant:  runs trader example stories using Ant</li>
 <li>trader-annotations:  extends trader example verifying configuration via annotations</li>

examples/threads/README.md

@@ -0,0 +1,5 @@
+Have a look ath the <threads> element within the pom.xml of this example.
+
+By default, two threads are going to execute stories. There are three stories, so two will go in parallel, followed by the third on its own.
+
+If you do mvn install -Dthreads=1 you're overiding the <threads> setting of the pom file.