Updated the documentation with some mailing list feedback