PEP257 is our recommendation for now. It's up to you how you integrate your module documentation with Sphinx. There are already few examples in `docs/` that you can follow. Otherwise you can write an RFC on "How to document module."

--

see https://github.com/jirikuncar/invenio/issues?labels=RFC&page=1&state=open