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!

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.

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).

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.

4) "Invalid syntax" means you typed something that it wasn't able to  
understand. (This could be many different things...)

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.

6) N(pi),1000) -> N(pi, 1000)

Very nice examples in section 4 & 5.

- Robert

--~--~---------~--~----~------------~-------~--~----~
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
-~----------~----~----~----~------~----~------~--~---

Reply via email to