Update the stable version of our documentation

**Description of documentation issue or suggestion**
Many fixes and improvements in our latest docs haven't been backported to the stable version yet.

**Proposal to fix issue or enact suggestion**
Update the stable version of our documentation by cherry-picking applicable fixes and improvements from the development branch.
