Fix documentation

Noticed some note sections of the documentation not being displayed.
.. note: was used instead of .. note::

Found other occurrences with 'tip' and 'important'.