migrated to asciidoc including some content improvements