> > How much more informative if instead it could become something like >> #*** Imports and magic >> import mypackage >> my_magic_number = 42 >> #*** class definition >> class A(object): >> #*** *** method 1 >> def method1(self): >> pass >> # description of aims of method >> #*** *** method 2 >> def method2(self): >> pass > > > What do you gain by such redundant comments?
Every Python programmer knows that 'class' is a class definition and 'def' (within a class) a method definition. The aims of a method should be expressed by its name. And for additional commentary information is ample room within the method itself. Reinhard -- You received this message because you are subscribed to the Google Groups "leo-editor" group. To unsubscribe from this group and stop receiving emails from it, send an email to leo-editor+unsubscr...@googlegroups.com. To post to this group, send email to leo-editor@googlegroups.com. Visit this group at http://groups.google.com/group/leo-editor. For more options, visit https://groups.google.com/d/optout.