[doc] undisplayed notes, tips, and important sections

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