On Friday, November 6, 2015, John H Palmieri <jhpalmier...@gmail.com> wrote:
> At http://trac.sagemath.org/ticket/19503, we have a branch which > implements the omission of 'TESTS:' blocks in docstrings when you do 'foo?' > (and optionally, but this is not the default behavior, it can omit them in > the reference manual). There are pros and cons to this: for some time, our > documentation has said that TESTS blocks contain 'tests that are not > relevant to users', so it makes sense to hide them. On the other hand, some > of our docstrings may not follow this guideline and may contain TESTS > blocks that are actually useful. So do we hide them all, knowing that we > may be hiding some relevant information, or do we always display them? > > Please vote: > > > > [ > [ X] 'foo?' should NOT display TESTS blocks. > > > [ ] 'foo?' should display TESTS block. > > -- > John > > > -- > 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 > <javascript:_e(%7B%7D,'cvml','sage-devel%2bunsubscr...@googlegroups.com');> > . > To post to this group, send email to sage-devel@googlegroups.com > <javascript:_e(%7B%7D,'cvml','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. > -- Sent from my massive iPhone 6 plus. -- 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.
