fix: correct various documentation warts

There was no LICENSE file present and some of the docstrings either did
not match the annotated return types or were otherwise malformed. Fix
these small warts.