jayvdb added a comment. The `@deprecated` is also human readable. The 'problem' with adding 'Deprecated' to the docstring is they are not kept in sync with `@deprecated`. We have so many instances where this hasnt been done; it slips through code review, as we dont have a code style checker for it (and it would be difficult to create one).
But if you want to create a code style checker, that would also be great. This decorator could check if 'Deprecated.' is in the docstring already, and not add it. TASK DETAIL https://phabricator.wikimedia.org/T121366 EMAIL PREFERENCES https://phabricator.wikimedia.org/settings/panel/emailpreferences/ To: Sn1per, jayvdb Cc: Xqt, gerritbot, Sn1per, pywikibot-bugs-list, jayvdb, StudiesWorld, Aklapper, Jay8g, Spage _______________________________________________ pywikibot-bugs mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/pywikibot-bugs
