more adjustments for documentation