If we wanted to generate docs with Sphinx in the future, it wouldn't be a bad idea to use Sphinx-style formatting here.