add docs
add .yardoc
use the real true / false instead of strings
update README to point to docs
bump version and date
update docs