#14090: Thematic tutorials: using the notebook, programming python,
comprehensions
-----------------------------------------------------------------------------+
Reporter: nthiery |
Owner: mvngu
Type: enhancement |
Status: needs_work
Priority: major |
Milestone: sage-5.8
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:
-----------------------------------------------------------------------------+
Comment (by nthiery):
Replying to [comment:19 kcrisman]:
> 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.
Agreed, this is ugly. But it's about style and not content. So yes,
that should be for another ticket.
> * I'm torn between putting the programming ones immediately after the
intro ones or having them where they are. What do you think?
I just added a link from the intro to the programming tutorials.
> * Modeling Mathematics - that could be very confusing. I'd use a word
other than "modeling", as that means something very different to most
people.
I see the potential confusion. Yet I am strongly attached to the word
Modeling, because that's really what we are doing (in the sense of
http://en.wikipedia.org/wiki/Object-oriented_modeling, though we don't
necessarily have to use only object-oriented techniques). I changed
the title to "Modeling Mathematics on a computer". Is this better?
> * If you want to add even more things, please finish the review of the
Quickstarts at #13381!
:-)
This sounds nice! I'll try to have a more detailed look! For now I'll
focus on getting those in before they rot away.
> 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.
The \ is there in the .rst file.
> * "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" :-)
I think it is.
> 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!
:-)
Thanks again for the review!
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/14090#comment:21>
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.
