Fixes AsciiDoc syntax and tweaks the content for shell docs.