#14090: Thematic tutorials: using the notebook, programming python,
comprehensions
-----------------------------------------------------------------------------+
Reporter: nthiery |
Owner: mvngu
Type: enhancement |
Status: needs_work
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é, Karl-Dieter Crisman
Authors: Franco Saliola, Florent Hivert, Nicolas M. Thiéry, et al. |
Merged in:
Dependencies: |
Stopgaps:
-----------------------------------------------------------------------------+
Changes (by kcrisman):
* status: needs_review => needs_work
* reviewer: Samuel Lelièvre, Sébastien Labbé => Samuel Lelièvre,
Sébastien Labbé, Karl-Dieter Crisman
Comment:
Front page:
* I figured out the different typefaces - it's the different types of
links. Italics only for Sphinx links. I don't know whether this is worth
fixing - after #6495 it should be easy. The :class: link probably should
be different, though.
* I'm torn between putting the programming ones immediately after the
intro ones or having them where they are. What do you think?
* Modeling Mathematics - that could be very confusing. I'd use a word
other than "modeling", as that means something very different to most
people.
* If you want to add even more things, please finish the review of the
Quickstarts at #13381!
The introductory tutorial:
* "If you are browsing this document as a static web page, " - probably
add something here that the active instructions assume that you are
browsing it live. That's implicit, but explicit is better than implicit,
according to Python...
* "mathematics like this sin(x)-y3 by using dollar signs" - maybe one
should have \sin or something? The "sin" shouldn't be italicized.
* "Compute the products: M*v and v*M." - I'd use \cdot here
* "Still, it is possible to define symbolic functions without first
defining its variables:" - "their variables", maybe
* "colour it red" - I don't know whether US English is the Sage standard.
If it is, make it "color" :-)
Patchbot is giving this a green light, so I'd say fix the (mostly very
minor) things I pointed out and you've got a nice upgrade to the Sage
documentation on your hands!
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/14090#comment:19>
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.
