Thanks so much for this contribution @Stephanieorch - this is really great!
I have a couple of minor suggestions (mostly related to formatting). Would you prefer that I make those edits to your post myself, or direct message you with them? Either works for me.
I think we should ultimately plan to transition this into the main QIIME 2 documentation (ie., https://docs.qiime2.org). I want to talk with some of the other developers about where it would make sense to put this. We've talked about having a section for plugin-specific documentation, in which case this would fit really well in a section on the q2-diversity plugin, but we don't have that in place yet. We're tied up with the 2017.12 release, and then the holidays, so we can follow up with you about this in early 2018.
Thanks again!