improve description
flesh out test cases