fix/expand/shrink docs appropriately