On Monday, 9 February 2015 20:29:27 UTC+11, Simon King wrote: > > Hi! > > On 2015-02-08, Volker Braun <vbrau...@gmail.com <javascript:>> wrote: > > IMHO thats unnecessarily confusing for novices. You shouldn't have to=20 > > understand Python OOP to be able to read the documentation. INPUT > documents= > > the parameters, and nothing else. Of course such restrictions need to > be=20 > > mentioned elsewhere in the docstring. > > I agree. If x is, say, a polynomial, and x.bla() is some method, then > the documentation of bla should not refer to "self", but should refer to > it as "this polynomial". >
+1 -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegroups.com. To post to this group, send email to sage-devel@googlegroups.com. Visit this group at http://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.