clean up spec descriptions and common code