make Jay's recommended changes to documentation