improve the readability of the spec