add some documentation to the spec modules