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.

Reply via email to