Doctests are used to prevent regressions and (unwanted) backward incompatibilities. Since the code used in these modules are not ever going to be modified, it does not seem necessary to provide doctests, IMHO.
On Mon, Jun 14, 2010 at 6:34 PM, Dr. David Kirkby <david.kir...@onetel.net> wrote: > On 06/14/10 05:15 AM, Minh Nguyen wrote: >> >> Hi folks, >> >> In a recent thread [1] on sage-notebook, it was suggested that files >> under the component >> >> sage/server >> >> need not contribute to the total doctest coverage. > > That seems a slightly strange decision to me. From the link it is apparent > the code is still in use. To quote from there: > > "sage/server/notebook/worksheet.py cannot be removed since the sources > under server/notebook/* are still used by SageNB for conversion from > the old pickled data storage format to the new one." > > So why should it not be tested? > >> Taking a cue from >> that, today's coverage update [2] contains good news. > > This strikes me as rather fiddling things to make the statistics look > better. > >> I have blacklisted everything under sage/server in generating the new >> doctest reports at [2]. This now means that as of Sage 4.4.4.alpha0, >> the overall weighted coverage score is 84.6%. Previously, the number >> of strategic modules was 180, i.e. we needed to get 180 modules up to >> full coverage in order to meet the 90% coverage goal. Now, the number >> of strategic modules is down to 140. > > This reminds me of the saying: > > "There are lies, damn lies, and statistics". > >> [1] >> http://groups.google.com/group/sage-notebook/browse_thread/thread/a07e542145ec1c99 >> >> [2] http://sage.math.washington.edu/home/mvngu/doctest-coverage/ > > > Dave > > -- > To post to this group, send an email to sage-devel@googlegroups.com > To unsubscribe from this group, send an email to > sage-devel+unsubscr...@googlegroups.com > For more options, visit this group at > http://groups.google.com/group/sage-devel > URL: http://www.sagemath.org > -- Tim Joseph Dumol <tim (at) timdumol (dot) com> http://timdumol.com -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org
