improve-readme

- Improve README.

- Add missing docstrings to test helpers.

- Split logging helper into a distinct module.