What's wrong with "Set plot_points to a higher value to get more detail." On 1 Aug 2014 20:09, "kcrisman" <[email protected]> wrote:
> 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 a topic in the > Google Groups "sage-devel" group. > To unsubscribe from this topic, visit > https://groups.google.com/d/topic/sage-devel/k3kIRIk475A/unsubscribe. > To unsubscribe from this group and all its topics, 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. > -- 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.
