assorted cleanup to documentation