Hi Martin,
Very nice! It's been on my Sage to-do list for some time to attempt
something similar for the wiki or the developer's guide. At a
minimum, I hope this presentation can get a pointer from the wiki
(once its completed) from someplace other than just the SD16 pages.
Some suggestions:
1. The "Python in a Nutshell" is another good Python book, which
William recommends along with "Dive Into Python." They complement
each other nicely - the first is a good bedtime read, the second is a
handy reference.
2. I very often use search_src('def foo(') to discover where, and
how, the function foo is implemented. Might not be obvious to those
who are new to Python, yet still want to explore the code.
3. Does "make test" require more compilation than "sage -b; sage -
testall"? I've found the latter seems to suffice, and only use the
former when I build from source, but maybe they have the same net
effect, or the latter misses some things. I don't know enough about
the build system to know for sure.
4. It took me a while to discover that devel/sage is a symlink to
whatever branch/clone is currently "active." Especially at first when
I'd see, for example, devel/sage/sage/misc/latex.py and I really
didn't know why the sage needed to be repeated. Add in the sage-main
directory to enhance the initial confusion. So the notion that sage -
b myclone changes this symlink to "sage-myclone" is a helpful thing
to know.
5. The drill:
sage -b main
sage -update <URL-to-upgrade-bits>
is nice to know if you want to keep the "main" branch up-to-date for
subsequent clones.
6. Michael Abshoff once said on Trac "no such thing as a 'negative
review'" (probably more than once, I'd guess). It'd be a nice
comment in your patch-naming section to reinforce your comments later
about the civility of the Sage community.
Again, nice job on this, and I think it will be very helpful for those
wishing to get started contributing code.
Rob
--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to sage-devel@googlegroups.com
To unsubscribe from this group, send email to
sage-devel-unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URLs: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---
