update comments about how rest periods work