Improve documentation and markdown