more docs (YARD + Markdown)