updating options-collections docs

Made some updates. I'm not sure how to go about getting these into gh-pages, so I'm just doing a pull request here.