http://sphinx-doc.org/domains.html#info-field-lists and there are lots of examples in Grok.

I think what you have here is clear enough for someone using it as a sample.  They are more likely to be reading the source than they would be from generated documentation, and it's obvious what is meant.  I don't think it's that big of a deal for this, but moving forward as we expand inline documentation, I'd prefer to use sphinx-compatible notation.