[sage-devel] Re: Poll for issue G3 a specific guideline for writing docstrings

2017-05-18 Thread Simon King
-1, and very strongly -1. Reason: On 2017-05-17, Kwankyu Lee wrote: > G3. Write (1) > > Return True if the lattice is reflexive. This leaves open what the function returns if it is not reflexive. None? False? A certificate that proves that it isn't reflexive? > but do not write (2) > > Return

[sage-devel] Re: Poll for issue G3 a specific guideline for writing docstrings

2017-05-18 Thread Marc Mezzarobba
Kwankyu Lee wrote: > G3. Write (1) > > Return True if the lattice is reflexive. > > but do not write (2) > > Return True if the lattice is reflexive and False otherwise. > > nor (3) > > Return whether the lattice is reflexive. > > nor (4) > > Test if the lattice is reflexive. X -- Marc -

[sage-devel] Re: Poll for issue G3 a specific guideline for writing docstrings

2017-05-17 Thread Eric Gourgoulhon
-1 (fully agree with Vincent) -- 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-de