[Pulp-dev] Redundancy in docstrings and serializer help_text
Austin Macdonald
austin at redhat.com
Wed Aug 9 18:48:12 UTC 2017
I propose that we remove fields from the docstrings of our models with
serializers and exclusively use the help_text of the serializers.
Reasons:
1. docstrings and help_text contain identical information.
2. help_text will become documentation, so we have to use it.
3. For master/detail models and serializers, fields are inherited so each
plugin awkwardly duplicates the fields into their docstrings. That is a lot
of duplication! Since serializers are inherited, help_text is inherited
too, and we can keep our docs/comments DRY and up to date.
I have done this for importers in this PR:
https://github.com/pulp/pulp/pull/3117
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://listman.redhat.com/archives/pulp-dev/attachments/20170809/752c3263/attachment.htm>
More information about the Pulp-dev
mailing list