X

In some context, the technical term ``self`` might be easier to 
understand (for someone who knows python...) than natural language,
in other context it may be the other way around

Maybe +1 as a rule of thumb, but -1 as a strict rule.

On 2017-05-17, Kwankyu Lee <ekwan...@gmail.com> wrote:
> We do a poll for adopting an official guideline for docstrings (see 
> https://trac.sagemath.org/ticket/23017)
> --------
> G2. Write
>
> if the lattice is reflexive ...
>
> but don't write
>
> if ``self`` is reflexive ...
>
> --------
> If you agree, flag +1; if you disagree and want it reversed, flag -1; if 
> you think we do not need this guideline, flag X.
>

-- 
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 https://groups.google.com/group/sage-devel.
For more options, visit https://groups.google.com/d/optout.

Reply via email to