Re: [sage-devel] Re: About oneliners in TOC vs. docstring

2017-05-18 Thread Jori Mäntysalo

On Thu, 18 May 2017, Vincent Delecroix wrote:


Yep, seems to be nicer. But maybe we should first see if we want to have
"test if..." -structure in function docstrings.


How is this different from the poll G3 where everybody seems to agree - -


I think that the poll is still open.

--
Jori Mäntysalo

Re: [sage-devel] Re: About oneliners in TOC vs. docstring

2017-05-18 Thread Kwankyu Lee


On Thursday, May 18, 2017 at 10:59:35 AM UTC+2, vdelecroix wrote:
>
> On 18/05/2017 10:33, Jori Mäntysalo wrote: 
> > On Thu, 18 May 2017, Kwankyu Lee wrote: 
> > 
> >>   is_sectionally_complemented() | Return True if every interval 
> >>   from the bottom is complemented. 
> >> 
> >> I would write: 
> >> 
> >> is_sectionally_complemented() | Test if every interval from the bottom 
> is 
> >> complemented. 
> > 
> > Yep, seems to be nicer. But maybe we should first see if we want to have 
> > "test if..." -structure in function docstrings. 
>
> How is this different from the poll G3 where everybody seems to agree 
> that we should use 
>Return whether every interval from the bottom is complemented 
>
> ?! 
>

My suggestion was to his "index", which I thought a somewhat informal list 
of functions and descriptions about them. This is not my opinion about G3, 
and I respect the result of the poll G3.
 
 

-- 
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.


Re: [sage-devel] Re: About oneliners in TOC vs. docstring

2017-05-18 Thread Vincent Delecroix

On 18/05/2017 10:33, Jori Mäntysalo wrote:

On Thu, 18 May 2017, Kwankyu Lee wrote:


  is_sectionally_complemented() | Return True if every interval
  from the bottom is complemented.

I would write:

is_sectionally_complemented() | Test if every interval from the bottom is
complemented.


Yep, seems to be nicer. But maybe we should first see if we want to have
"test if..." -structure in function docstrings.


How is this different from the poll G3 where everybody seems to agree 
that we should use


  Return whether every interval from the bottom is complemented

?!

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


Re: [sage-devel] Re: About oneliners in TOC vs. docstring

2017-05-18 Thread Jori Mäntysalo

On Thu, 18 May 2017, Kwankyu Lee wrote:


  is_sectionally_complemented() | Return True if every interval
  from the bottom is complemented.

I would write:

is_sectionally_complemented() | Test if every interval from the bottom is
complemented. 


Yep, seems to be nicer. But maybe we should first see if we want to have 
"test if..." -structure in function docstrings.


--
Jori Mäntysalo

[sage-devel] Re: About oneliners in TOC vs. docstring

2017-05-18 Thread Kwankyu Lee

>
>
> However, in the index I use 
>
> is_sectionally_complemented() | Return True if every interval from the 
> bottom is complemented. 
>

I would write:

is_sectionally_complemented() | Test if every interval from the bottom is 
complemented. 

-- 
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.