Feb 3, 2015
The symbiosis of test and documentation
We want to build a library of reusable widgets, which are tested and documented. The components of the Tasklist search are examples for such widgets: This blog entry describes how we document and test widgets and make sure that tests and documentation stay in sync. Tests With E2E tests we specify and test the desired behavior of the widgets. For our angular widgets, we use Protractor. E2E tests interact with a webpage, e.g. by clicking on links and buttons or typing text. This simulates the user behavior. To run these tests, we have to create the webpages the tests use. These webpages display the widget in the environment we want to test. Documentation For the documentation, we describe the interface…