more adjustments to documentation