Minor point, but I prefer the long form of the note directive if the content is big to fit on a single line. i.e.
```
.. note::

    content goes here.
```