adding more utilities, cleaning up documentation