Renamed the docs rake task to `rake doc'

Also added vendor/seahorse into the path for generating docs.
Fixed a few yard doc errors.