[issue18355] Merge super() guide into documentation
New submission from Russkel: When looking for documentation on the correct usage on super (http://docs.python.org/2/library/functions.html?highlight=super#super), the documentation links to this rather will written blog post http://rhettinger.wordpress.com/2011/05/26/super-considered-super/ by Mr. Hettinger. I think there is value in merging that blog post into a HOWTO and including in the official documentation. I'm more than willing to create a patch if this is considered a good idea. ---------- assignee: docs@python components: Documentation messages: 192262 nosy: Russkel, docs@python, rhettinger priority: normal severity: normal status: open title: Merge super() guide into documentation _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18355> _______________________________________
Mark Lawrence added the comment: @Raymond what is your opinion on this proposal? ---------- nosy: +BreamoreBoy type: -> enhancement versions: +Python 3.5 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18355> _______________________________________
Raymond Hettinger added the comment: I'll translate it into a How-to guide when I get a chance. Right now, the content is in great shape, but the tone is somewhat "blog-posty". For now, the external link will have to suffice. ---------- priority: normal -> low _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18355> _______________________________________
Changes by Raymond Hettinger <raymond.hettinger@gmail.com>: ---------- assignee: docs@python -> rhettinger _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18355> _______________________________________
Changes by Chris Rebert <pybugs@rebertia.com>: ---------- nosy: +cvrebert _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18355> _______________________________________
Change by Mark Lawrence <breamoreboy@gmail.com>: ---------- nosy: -BreamoreBoy _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue18355> _______________________________________
Jeroen Demeyer <J.Demeyer@UGent.be> added the comment: I opened another doc issue about super(): #37176 ---------- nosy: +jdemeyer _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue18355> _______________________________________
Raymond Hettinger <raymond.hettinger@gmail.com> added the comment: I think for now I'll leave this as an external supplement to the documentation. My previous experience with moving a personal blog post into the main docs didn't go so well. ---------- resolution: -> rejected stage: -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue18355> _______________________________________
participants (5)
-
Chris Rebert -
Jeroen Demeyer
-
Mark Lawrence
-
Raymond Hettinger
-
Russkel