updates docs and a test