updated docs and a test for previous commit