raml2html/README.md: enh. test:compare doc

Author: adriendupuis

tools/raml2html/README.md

@@ -14,16 +14,20 @@ composer install;
 
 ## Usage
 
+### Generate
+
 To generate static HTML from RAML definitions, use the following code from project root:
 
 ```sh
 php tools/raml2html/raml2html.php build --non-standard-http-methods=COPY,MOVE,PUBLISH,SWAP -t default -o docs/api/rest_api/rest_api_reference/ docs/api/rest_api/rest_api_reference/input/ibexa.raml
 ```
 
-To test static HTML against an Ibexa DXP to find missing routes and removed routes:
+### Compare documented routes with DXP configured routes
+
+To test static HTML against an Ibexa DXP to find routes missing from the doc, and routes removed from the DXP:
 
 ```sh
-php tools/raml2html/raml2html.php test:compare ~/ibexa-dxp docs/api/rest_api/rest_api_reference/rest_api_reference.html
+php tools/raml2html/raml2html.php test:compare ~/ibexa-dxp
 ```
 
 Note: The Ibexa DXP doesn't need to run.
@@ -34,5 +38,5 @@ cd ~/ibexa-dxp;
 composer create-project ibexa/commerce-skeleton . --no-install --ignore-platform-reqs --no-scripts;
 composer install --ignore-platform-reqs --no-scripts;
 cd -;
-php tools/raml2html/raml2html.php test ~/ibexa-dxp
+php tools/raml2html/raml2html.php test:compare ~/ibexa-dxp;
 ```