added/updated tests, added doc string to method