EPytext has a luscious set of directive-like tags. Specically @note and @todo.
Because I'm also using Sphinx, I'm switching to a docformat of RST. Which doesn't seem to have all the same directives.
There are two specific directives which are essential:
- a ``.. todo::`` directive would mean that my epydoc TODO list matched my sphinx todo list for those few modules which are referenced directly by Sphinx.
- a ``.. note::`` directive to create a proper admonition paragraph.