Mass docstring and .rst documentation fixes

This PR started with a major cleanup in docstrings and restructured text documentation, and evolved into finding bugs into inspekt and removing scripts that have been replaced by inspektor.