docs: remove docstring types and clean up formatting

[jsstevenson]

No functional changes, and it probably won't matter, but the extra type declarations were distracting me so I went through and pulled them all out