On Sep 26, 6:05 pm, Robert Bradshaw <rober...@math.washington.edu> wrote: > On Sep 26, 2009, at 3:45 PM, lutusp wrote: > > > > > I 'm in the process of writing a Sage tutorial at http:// > > arachnoid.com/sage. > > I'm about about halfway through the project, the completed pages may > > be a useful resource, and I wanted to (1) announce this, and (2) ask > > for comments from people willing to read the articles. > > Very cool, we can always use more quality documentation!
Thank you! > > Some comments > > 1) Several places you have > > sage: var('a b c d') > (a b c d) > > There should be commas between the variables in the output. Fixed, thank you. > > 2) It'd be nice to disable the double-click for definition in the > input/output cells, as it makes it hard to hilight stuff (and the > hover-then-copy isn't working for me). After much effort, it turns out I can't do this (disable double- click). Sorry. I had hoped everyone would be able to click-and-drag across the input cells. Can you please tell me if clicking once and dragging across the input cells works for you? I ask because I've discovered that double-clicking (even triple- clicking) won't automatically select a multi-line text block (in any browser), and many of my input boxes are in this class. So for this copy & paste business to work at all, people must be able to to click & drag. I also know that an explicit pushbutton approach to copying text to the clipboard is now out for security reasons. All this clicking an dragging seems rather primitive, but there are no alternatives. > 3) "In computer math, operations inside parentheses are performed > before operations outside parentheses. " Actually, this is the > general rule for non-computer math as well. Changed. I know what I had in mind, but I agree it's misleading. > 4) "Invalid syntax" means you typed something that it wasn't able to > understand. (This could be many different things...) Reworded. > > 5) "The reason Sage didn't automatically provide a numerical result > has to do with something called "complex numbers" (even though the > argument is explicitly numerical)." > > Well, actually it's because the square root couldn't be represented > exactly. Another more colloquial way to say that, which would flow > nice, is that it doesn't know how many digits you want. Reworded -- and I think the new version is more entertaining, referring to the exalted position of integers in mathematics. > > 6) N(pi),1000) -> N(pi, 1000) Fixed. > > Very nice examples in section 4 & 5. Thank you! And thank you as well for your useful comment and corrections. Apart from the double-click issue, I've incorporated them all. I am more than open to any further comments you would like to make. --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---