numerous changes to documentation