-1, and very strongly -1.
Reason:
On 2017-05-17, Kwankyu Lee <ekwan...@gmail.com> 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 True if the lattice is reflexive and False otherwise.
This is one clear way to say what is returned.
> nor (3)
>
> Return whether the lattice is reflexive.
This is another clear and actually very elegant way to say what
is returned.
> nor (4)
>
> Test if the lattice is reflexive.
Here I agree that this is not clear enough. Does it return
``None`` if the lattice is reflexive and raises an error otherwise?
Summary: I believe the short one-line description should be
as clear as possible in a one-liner. It *is* possible to be concise
in this case ("Return whether the lattice is reflexive"), and thus
one *should* be concise.
Cheers,
Simon
--
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.
