documentation improvements [ci skip]

* Update yardopts to embed mixins for docs
* Update/fix several spots in the docs
* Hide Trollop from yard.
* Add LICENSE and CONTRIBUTING to yardocs