updating documentation and tests