add test doubles and update docs