It looks great, I can't wait to see more of this! The first chapter
already looks very polished, but I managed to find some typos and
other things to nag about anyway. :) Later I will try to give feedback
on a higher level.
(This is about the file book3.pdf.)
Aesthetics:
* In your screen shots I would remove the back grounds to eliminate
the nonessential and create a higher signal to noise ratio (the empty
space will make you focus on what matters).
* On several places you write '<text>' where you might want to use
`<text>' (you do this already for double quotes).
Typos:
p 8. "is uses Twisted" -> "it uses Twisted"
p 9. You say one can start the notebook from the command line by
typing "./sage -notebook", but then you write "./sage -inotebook" in
your example. (Just out of curiosity, what is the difference?)
p 9. Maybe take Exercise 1.3.1 and 1.3.2 together because they are so
similar: "Using the Sage command line or notebook, compute 123 + 456."
Like it looks right now, it might seem to be a little belittling. If
they can do it one, I'm sure they can do it in the other.
p 9. "... and work *in* almost the same way *in both*" -> "... and
work almost the same way" (elimimate the nonessential)
p 10. "... you can do with something" -> "... you can do with your
object" ("something" is weak here)
p 11. "If n is any object in Sage and foo any function" You name your
function "foo" but you don't use this name afterwards.
p 11. "you can also type n.factorial(" -> "you can also type
n.factorial?" For clarity reasons it is best to stick with one way to
call the documentation.
p. 12. "type t = walltime() then later type walltime(t)" -> "type
instead t=walltime() and walltime(t)"
p. 13. "... call the file filename.sage" -> "... call the file \verb|
filename.sage|"
p. 13. "... something besides hello printed out" -> "... something
besides ``hello'' printed out"
p. 13, footnote 2. "the pickle module" -> "the \verb|pickle| module"
p. 14. "... end of the filename, if it isn't given" -> "... end of the
filename if it isn't given"
p. 14. "Not only can you load and save individual objects, but you can
save all save-able objects defined in the current session" I don't
understand what distinguishes "save-able objects" from "individual
objects". Maybe the second "objects" should change to another word?
p. 16. "multiplyling" -> "multiplying"
p. 16. "e.g., other lists, etc." You need only one of "e.g." and
"etc."
p. 20. "and uses similar slices notation similar to lists" -> and uses
slice notation similar to lists"
p. 20. "can use backslash" -> "can use a backslash"
p. 22. "by typing\\ tt dict(v)" -> "by typing \verb|dict(v)|"
p. 22. "totally devasate" -> "devastate"
p. 22. "The list v= [1,2]" -> "The list v = [1,2]"
p. 23. "e.g., union, intersection, etc." Remove either "e.g." or
"etc.".
p. 24. "\textit{c}ould" -> "\textit{could}"
p. 24. "since every x in v requires" -> "since every command x in v
requires"
p. 25. "writing or indeed using" -> "writing or using"
p. 25. "This is a good thing, e.g., this occurs..." -> "This is a good
thing. For instance, this occurs..."
p. 25. "These same sort of issues" -> "Similar issues"
p. 26. "increase the chances it might always work correctly" ->
"increase the chance for it to work correctly"
p. 28. "with the algebraic objects of mathematics such as" -> "with
the algebraic objects of mathematics, such as"
p. 28. "arbitrary precision integer" -> "arbitrary precision integers"
p. 28. "and other object" -> "and other objects"
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sage-edu" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/sage-edu?hl=en
-~----------~----~----~----~------~----~------~--~---
