Minor improvements to W3C Validator plugin README

w3c_validate/README.md

@@ -1,19 +1,25 @@
 # w3c_validate plugin
 
-W3C validator (http://validator.w3.org) plugin for generated HTML content.
+This is a plugin for Pelican that submits generated HTML content to the
+[W3C Markup Validation Service](http://validator.w3.org/).
 
-After all content is generated, output folder is traversed for HTML files, and
+After all content is generated, the output folder is traversed for HTML files,
-their content validated on W3C and the results displayed, for example:
+and the content is submitted to the W3C validator, after which the results
+are displayed. For example:
 
     -> writing /tmp/_output/sitemap.xml
     -> Validating: /tmp/_output/archives.html
-    ERROR: line: 2; col: 52; message: Bad value http://www.w3.org/1999/html for the attribute xmlns (only http://www.w3.org/1999/xhtml permitted here).
+    ERROR: line: 2; col: 52; message: Bad value http://www.w3.org/1999/html for the attribute xmlns (only http://www.w3.
     -> Validating: /tmp/_output/categories.html
-    ERROR: line: 2; col: 52; message: Bad value http://www.w3.org/1999/html for the attribute xmlns (only http://www.w3.org/1999/xhtml permitted here).
+    ERROR: line: 2; col: 52; message: Bad value http://www.w3.org/1999/html for the attribute xmlns (only http://www.w3.
+
+**Note**: The above output assumes you have called Pelican with the ``--debug``
+flag. Otherwise, you will see errors (if any) but not the file currently being
+validated.
 
 ## Dependencies
 
-* py_w3c, https://pypi.python.org/pypi/py_w3c/0.1.0 , which can be installed with pip:
+* [py_w3c](https://pypi.python.org/pypi/py_w3c/0.1.0), which can be installed with pip:
 
     $ pip install py_w3c
 
@@ -21,6 +27,3 @@ their content validated on W3C and the results displayed, for example:
 
 [ ] - add tests
 
-
-
-