> > 1. Test that code produces the expected output >>> 2. Document what sage can do >>> >>> The 1000 point resolution is not so useful for 1, but is useful for 2 -- >>> it illustrates that sage can produce very high quality graphics >>> >> >> IMHO the doctest should test that the plot_points optional keyword >> argument is accepted and works. Does it really require an example to >> illustrate that more points yields more accurate graphics? >> > > For this particular example, I think you're right -- I should have chosen > a better example to illustrate my point. >
I disagree. The documentation is not JUST to provide doctesting but also examples for users. In this case, they might not know that e.g. 1000 (or 500, or 101) might provide enough more detail. It's sort of saying our recommendation for more details. That said, 200 or 150 should be fine for testing. But it should be bigger! -- 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 [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.
