docs: punctuation

[jly36963]

Not the most substantial PR, mostly a way for me to:

• make an easy first contribution
• get in a copy-editor mindset, in order to read the docs more thoroughly.

Hopefully more meaningful contributions in the future 😄

[gustavoguichard]

@jly36963 could you squash those commits prior to the merging?