Author jmg
Recipients andrei.avk, eric.smith, jmg, rhettinger, terry.reedy
Date 2021-07-20.18:20:02
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1626805203.01.0.506493151889.issue42414@roundup.psfhosted.org>
In-reply-to
Content
Though this suggestion does work, I am not a fan of this solution.

The issue is that it separates the doc from the definition.  This works well if you have only a field fields in the class, But if you get 10-20+ fields, it moves away the docs and makes it easier for people to forget to add documentation to the field when they add additional fields, where w/ my suggestion, it's less likely that it will be forgotten.

Note: I would look at making a patch, but as I don't plan on signing the contributor's agreement, any patch I make will not be usable.
History
Date User Action Args
2021-07-20 18:20:03jmgsetrecipients: + jmg, rhettinger, terry.reedy, eric.smith, andrei.avk
2021-07-20 18:20:03jmgsetmessageid: <1626805203.01.0.506493151889.issue42414@roundup.psfhosted.org>
2021-07-20 18:20:03jmglinkissue42414 messages
2021-07-20 18:20:02jmgcreate