improve docstring parsing

there is a nice pypi package which does docstring parsing in a convenient way. At some point we should switch to that instead of our home-brew solution..

see https://pypi.org/project/docstring-parser/

Edited by Bert Palm