docs: fix typo and minor style changes to improve readability

[k-dimple]

Thanks @toabctl! I do not have write access to this repo, so could you please merge it too? (And possibly give me write access?)