Updated.

Author: sideshowbarker

README.md

@@ -101,9 +101,9 @@ executable provides the following options:
 
     Shows the vnu.jar version number.
 
-For details on using the `vnu.jar` validator to provide validation of HTML
-documents over the Web (in a Web browser, as an HTTP service), see [Using
-vnu.jar for Web-based validation][3].
+For details on using the `vnu.jar` validator to provide a service for
+browser-based validation of HTML documents over the Web, see [Using vnu.jar for
+Web-based validation][3].
 
    [3]: http://validator.github.io/web-based-usage.html
 

index.html

@@ -121,9 +121,8 @@ <h4 id="version">--version</h4>
 </section>
 </div>
 
-<p>For details on using the <code>vnu.jar</code> validator to provide
-validation of HTML documents over the Web (in a Web browser, as an HTTP
-service), see
+<p>For details on using the <code>vnu.jar</code> validator to provide a
+service for browser-based validation of HTML documents over the Web, see
 <a href="http://validator.github.io/web-based-usage.html">Using vnu.jar for Web-based validation</a>.
 
 <p>

web-based-usage.html

@@ -8,8 +8,8 @@ <h1>Using vnu.jar for Web-based validation</h1>
     <a href="https://github.com/validator/validator.github.io/releases"
       >latest version</a>
     is available from the validator area at github.
-    The following are instructions on how to use it to do Web-based
-    (browser-based) validation of documents.
+    The following are instructions on how to use it to provide a
+    service for browser-based validation of HTML documents over the Web.
 
 <p class=note><b>Note:</b> In the instructions, replace
 <var>"~/vnu.jar"</var> with the actual path to the <code>vnu.jar</code>
@@ -24,14 +24,15 @@ <h1>Using vnu.jar for Web-based validation</h1>
   <section id=web-based-usage>
   <h2>Web-based usage</h2>
 
-    <p>The <code>vnu.jar</code> validator provides a way for you to
-    validate HTML documents over the Web, in a Web browser, as an HTTP
-    service—just as with
+    <p>You can use <code>vnu.jar</code> to provide a service for
+    browser-based validation of HTML documents over the Web, similar to
     <a href="http://html5.validator.nu/">http://html5.validator.nu/</a>
     and
     <a href="http://validator.w3.org/nu/">http://validator.w3.org/nu/</a>.
+    The service also includes a REST API for providing validation of HTML
+    documents to non-browser clients.
 
-    <p> To run the validator as an HTTP service, open a new terminal window
+    <p>To run the validator as a service, open a new terminal window
     and invoke <code>vnu.jar</code> like this:
 
 <pre>