doc: typo and formatting fixes

[Alienmaster]

Small typos and changes for readability.

[terriko]

Approved this to re-run but it's going to fail the conventional commits linter. You can read more about conventional commits here: https://www.conventionalcommits.org/en/v1.0.0/

But probably a good message here would be "doc: typo and formatting fixes" -- if you set that as your pull request title, it'll resolve the linting error going forwards.

[terriko]

Thanks! You've got a fix for the doctest issue in another PR and I've got one for black in one as well, so none of the failing tests in CI need to be addressed by this PR. I'm going to go ahead and merge it while we wait for the others to resolve (this should also make it so your workflows run automatically on the other PR going forwards, so it'll make it easier to work on that one!)