Update, clarify, and fix the documentation.