Add doctest to the bilby test suite

At the moment examples in docstrings aren't included in the bilby testing process. In order to improve the project's documentation automated doctest discovery should be implemented. Doctest integration with the unittest API is documented here.