documentation adjustments