reword documentation, update tests