#14090: Thematic tutorials: using the notebook, programming python,
comprehensions
-----------------------------------------------------------------------------+
Reporter: nthiery |
Owner: mvngu
Type: enhancement |
Status: needs_review
Priority: major |
Milestone: sage-5.7
Component: documentation |
Resolution:
Keywords: thematic tutorials |
Work issues:
Report Upstream: N/A |
Reviewers: Samuel Lelièvre, Sébastien Labbé
Authors: Franco Saliola, Florent Hivert, Nicolas M. Thiéry, et al. |
Merged in:
Dependencies: |
Stopgaps:
-----------------------------------------------------------------------------+
Comment (by kcrisman):
Python tutorial:
* Dive into Python does still exist because of the license, but the
author has essentially repudiated it. In any case, the link is broken.
* "The elements of a set must be hashable:" - do these readers know what
that means? Give an example of something that isn't.
* "Blocks are delimited thanks to indentation." Hmm. It works, but
seems stilted. Maybe "solely by means of" or "by means of" or "using" or
something like that.
* Some examples of all those control structures would be good.
* "Todo Introduction to the debugger." To do?
* With `range`, probably you should at least make some mention of
`xrange`, `srange`, `sxrange`, and friends and what they do. Edit: point
to further down where you do.
* "The integer generated by range() are python int‘s" should have
"integers" and "Python", probably.
* I'm a little confused about the structure of this document. You have
this big list of stuff, and then exercises, and then magically lots of
explanation of the stuff (like control structures) you glossed over
earlier. ??? There is some redundancy, I think.
* Again, I highly recommend pointing out `zip`.
* "That is, it cannot be changed once it is created." Maybe talk about
why that might be useful.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/14090#comment:18>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.
