John-Mark Gurney <j...@funkthat.com> added the comment:

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.

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue42414>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to