update documentation
update test to utilise new test api