Fix various problems with YARD 0.8.5.2
Add some more sections to README