Markdown cleanups, improve example
Add yardopts
Documented existing adapters. YARrrDoc.