add documentation
clarified running tests