Raymond Hettinger <raymond.hettin...@gmail.com> added the comment:
I concur with Eric that the current presentation is reasonable and better than adding boilerplate to every entry. It suffices that the docs cover the *msg* argument once and that each entry includes *msg* in its signature. Elsewhere in the docs we also try to avoid unnecessary repetition (for example, most classes don't list all their dunder methods). Excess repetition in the docs impairs readability. The unittest docs are already so long that it discourages someone from reading it top to bottom. ---------- nosy: +rhettinger _______________________________________ Python tracker <rep...@bugs.python.org> <https://bugs.python.org/issue46081> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com