more intention revealing tests

Author: codescape

bitvunit-demo/src/test/java/de/codescape/bitvunit/demo/HtmlUnitDemoSpec.java

@@ -18,7 +18,7 @@ public class HtmlUnitDemoSpec extends AbstractBaseSpec {
 
     @Test
     public void testingAccessibilityWithHtmlUnit() throws Exception {
-        // Create a HtmlUnit WebClient instance
+        // create a HtmlUnit WebClient instance
         WebClient webClient = new WebClient();
 
         // navigate to a page or interact with a page

bitvunit-demo/src/test/java/de/codescape/bitvunit/demo/URLDemoSpec.java

@@ -18,7 +18,11 @@ public class URLDemoSpec extends AbstractBaseSpec {
 
     @Test
     public void testingAccessibilityWithSimpleURL() throws Exception {
-        assertThat(new URL(urlForPage("index.html")), is(compliantTo(ALL_RULES)));
+        // create a URL
+        URL url = new URL(urlForPage("index.html"));
+
+        // assert accessibility
+        assertThat(url, is(compliantTo(ALL_RULES)));
     }
 
 }