Fixed asciidoc files and the summary.

I don't consider this good practice, but until Asciidoctor has
something more sensible this is what we're stuck with