appropriate docs were recommended to be delayed as this PR is blocking progress on unifrac. However, I can work on those right now if that is the preferred direction forward.