docblocks adjustments