> Did you test to build the rst files to html?

No. Perhaps you're right. I was just surprised by this unusual (for me) syntax :)
In other pages (eg. https://raw.github.com/camptocamp/c2cgeoportal/master/doc/integrator/create_application.rst) I see that we generally use the following syntax:

```
.. note::

    Some text here...
```
but I have no objection if yours works as well.