anchor.diff:  
   This is an apiman gateway implemented using http://www.vertx.io[Vert.x 3].
   
  +NOTE: **You should also refer to the documentation specific to the configuration you're using. This README provides a high-level, generic overview.**
  +
   toc::[]
   
  -== Running
  -You'll need to have a valid JSON config (see following sections), and build apiman with Java 8 (`mvn clean install`):
  +== Building & Running
  +
  +This module can be built with `mvn clean install`.
  +
  +To run the Vert.x apiman gateway, you'll need to have a valid JSON config (see following sections), and build apiman with Java 8 (`mvn clean install`):
   
   ```shell
   java -jar target/apiman-gateway-platforms-vertx3-1.2.10-SNAPSHOT-fat.jar -conf <path-to-your-config.json>
  
positive.code: client.initialize=true
  client.apiman=great,fantastic,excellent
  ```
  ==== Comments
  
  Unlike standard JSON, you can insert comments into the configuration by using C-style `// comment` syntax.
  
negative.code: 
  ==== API
  
  Hosts the apiman gateway API, which is typically used by the apiman manager to drive the gateway.
  For instance, publishing and retiring APIs, Contracts.
  You probably only need 1 of these.
  
  === Gateway API Authentication
  
  NOTE: This only relates to apiman's Gateway API; it is *unrelated* to auth of traffic transiting the gateway.
  
  === Hostname
  
  ```json
  { "hostname": "localhost" }
  ```
  The hostname to bind to.
  
  === Endpoint
  
  ```json
  { "endpoint": "mynode.local" }
  