adding asciidoc generated from the html variant, and doc of how I did it