On Friday, March 2, 2012 9:15:08 AM UTC-8, daveloeffler wrote: > > Sorry, that got lost in sending: I meant "I wouldn't want to read > documentation of the Farey symbols module without some diagrams to explain > what was going on". >
+1 Sometimes a picture says more than a thousand words ;-) I'd say its fine (encouraged, even) to include graphics in the documentation if they help understanding what is going on. We should not include tons of graphics as doctests, a la: here is a picture of an ellipse, a square, a triangle, ... On Friday, March 2, 2012 9:15:08 AM UTC-8, daveloeffler wrote: > > > > On Friday, 2 March 2012 17:12:04 UTC, daveloeffler wrote: >> >> There are already a couple of images in the documentation of the >> "homology" Sage module that nobody has complained about so far. I >> don't think this is an issue. I wouldn't want to read documentation of >> the >> >> > Sorry, that got lost in sending: I meant "I wouldn't want to read > documentation of the Farey symbols module without some diagrams to explain > what was going on". > -- 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
