updated documentation with new acceptance tests.