further yard documentation progress
Merge pull request #1068 from yaauie/even-more-yarddoc

further yard documentation progress