updated spec for readability, utility