added some acceptance tests
added some documentation