anchor.diff:  
   To author your Maven-generated site in AsciiDoc, you must first add a dependency on the Asciidoctor plugin to your maven-site-plugin config:
   
  -[source,xml]
  +[source,xml,subs=attributes+]
   .Maven site integration
   -----
   <build>
  
positive.code: [source,xml]
  -----
  <body>
  ...
      <menu name="User guide">
          <item href="usage.html" name="Usage" />
      </menu>
  ...
  </body>
  -----
  
  
negative.code: 
   mvn clean test
  
  Or any of the other goals which run tests.
  
  NOTE: If I can figure out a good way to setup a Ruby testing environment I'll do that as well, but none exists at this time.
  
  == Tips & Tricks
  
  === Generate your documentation in separate folders per version
  
  [source, xml]
  -----
  <configuration>
      ...
      <outputDirectory>target/generated-docs/${project.version}</outputDirectory>
      ...
  </configuration>
  -----
  
  === Enable section numbering
  
  [source, xml]
  -----
  <configuration>
      ...
      <attributes>
          ...
          <sectnums>true</sectnums>
          ...
      </attributes>
      ...
  </configuration>
  -----
  