Yard

update to the latest yardstick/devtools, and clean up/expand a lot of the docs.