Hi,

In order to get Sage's doctest coverage to 75%, which is one of the
main goals for Sage-4.0, it is necessary to doctest about 1900
functions in the Sage library.   I just did a test (see
http://trac.sagemath.org/sage_trac/ticket/5724 and
http://trac.sagemath.org/sage_trac/ticket/5725) and it took me on
average about 2-3 minutes per doctest, including fixing a couple of
bugs I found.  Estimating 3 minutes each, that is about 95 hours of
nonstop work.

It is very easy to find files that are full of code that isn't
doctested and *must* be doctested.  It was trivial for me to find the
sequences and quotient_ring_element had very bad coverage.   In both
cases, I found *several* small bugs in both files.  Probably, any
random file with low coverage has several bugs in it.   That's why
getting the doctest coverage in Sage up is critical to Sage becoming a
truly high quality system.

I hope those of you who feel qualified to write doctests, will help
out.  It's nearly impossible for one person to do all 1900 of those
doctests in the next month.  Writing doctests is not easy and it
absolutely requires experience experience with the Sage library, and
good understanding of the code you are testing.

Thanks,

 William


-- 
William Stein
Associate Professor of Mathematics
University of Washington
http://wstein.org

--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to sage-devel@googlegroups.com
To unsubscribe from this group, send email to 
sage-devel-unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URLs: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---

Reply via email to