docs: typos and fixes

1:D400: First line should end with '.', not 'e'
1:D205: Blank line missing between one-line summary and description
1:D208: Docstring is over-indented