Avoid a # type ignore directive, improve comments & docstrings, and delete commented code blocks

Avoid a # type ignore directive, improve comments & docstrings, and delete commented code blocks #54