Added YARD and an example annotation

This is just a quick WIP. Going to write out annotated docs for the rest tonight - we should also copy over the DESIGN doc from the other repo and rework it with the content from the Google Groups thread.