added methods and tests
minor description changes