Document yield params
Move everything inside level 0 header in README
Add asciidoctor to Gemfile
Improve documentation