Note that you can write notes in Sphinx like `.. note:: blah blah` and it will show up [like this](http://freeseer.github.io/contribute/basics.html?highlight=note#reference-issues-in-your-commit-messages). In this case though, I think it's better to write the note [as a footnote](http://sphinx-doc.org/rest.html#footnotes) since it's more of a side-note.