Documentation review

For review and merge
There must be a directive for "cautions" in asciidoc, something that gets formatted correctly afterwards.