changes to documentation after proof reading