added a bunch of comments to the test client to help explain the api