Added "The state of this library" to the README
Fix various yardoc markup errors