fixed up the diversity stuff for a general overiew and started filling in the documentation for the package.