docs: spring cleaning with minor doc tweaks

[tylwright]

Very tiny tweaks to docs. Added new Markdown Alerts syntax that looks like this for callouts:

[garethgeorge]

Looks amazing, thanks for taking the time to clean this up :)

These types of doc contributions are hugely appreciated! It's a pretty high priority area of investment for me.