I'd love it if we could stop writing docs in the ":param foo:" style. Instead,
I think that we should use the sphinx extension "napoleon" to write docstrings
that are *way* more human-readable (in my opinion, at least) while still
generating good sphinx docs.

I think Napoleon's page in the sphinx docs explain this pretty well:

I've got like three more RFCs queued up; I'm trying to be nice and not overload
pulp-dev with all my crazy ideas simultaneously. :)

Attachment: signature.asc
Description: OpenPGP digital signature

Pulp-dev mailing list

Reply via email to