Misc. fixes

Small fixes to comments, docstrings and function signatures. I thought it would be dumb to open a separate issue for each of these, so I packaged them all into one merge request. Maybe I should just push straight to develop next time?