tidy docs and add test
adds another test