#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:
-----------------------------------------------------------------------------+
Description changed by nthiery:
Old description:
> This ticket adds three tutorials that have been developped and
> extensively used during Sage(-Combinat) events:
>
> - Tutorial: Using the Sage notebook, navigating the help system, first
> exercises
> - Tutorial: Programming in Python and Sage
> - Tutorial: Comprehensions, Iterators, and Iterables
>
> There is some redundancy with the PREP's tutorial, but that's fine:
> the point of views are complementary.
>
> At this occasion, this ticket also refactors the main Thematic
> Tutorials page, grouping them by theme, and cross-linking to thematic
> tutorials that are already in the Sage sources (combinatorics, padics)
> or other documents (PREP).
>
> Suggestions for a nicer way to link to the PREP documents are
> welcome. Shall we enable intersphinx there as well? Or should the
> PREP tutorial be simply merged in the thematic tutorials (is there a
> compelling reason to have separate documents?)
>
> The two first tutorials have been reviewed in depth by Samuel Lelièvre
> during the Sage days in Bobo Dioulasso.
>
> Note: intersphinx linking to the reference manual is currently broken;
> see #14091.
> The thematic tutorial page look a bit lame without it, but I would not
> wait until #14091.
New description:
This ticket adds three tutorials that have been developped and extensively
used during Sage(-Combinat) events:
- Tutorial: Using the Sage notebook, navigating the help system, first
exercises
- Tutorial: Programming in Python and Sage
- Tutorial: Comprehensions, Iterators, and Iterables
There is some redundancy with the PREP's tutorial, but that's fine:
the point of views are complementary.
At this occasion, this ticket also refactors the main Thematic
Tutorials page, grouping them by theme, and cross-linking to thematic
tutorials that are already in the Sage sources (combinatorics, padics)
or other documents (PREP).
A preview of the result is available here:
http://combinat.sagemath.org/doc/thematic_tutorials/
It might be slightly outdated w.r.t. the latest version of the
patch. Also one should ignore the SEEALSO section which is added by a
later patch in the Sage-Combinat queue.
Status:
- Sébastien and John checked the index page
- The two first tutorials have been reviewed in depth by Samuel Lelièvre
during the Sage days in Bobo Dioulasso.
- I proofread the last tutorial; but since I made changes, a last pass
of review would be needed.
- Intersphinx linking to the reference manual is currently broken;
see #14091. The thematic tutorial page look a bit lame without it,
but I would not wait until #14091.
- Suggestions for a nicer way to link to the PREP documents are
welcome. Shall we enable intersphinx there as well? Or should the
PREP tutorial be simply merged in the thematic tutorials (is there a
compelling reason to have separate documents?)
--
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/14090#comment:13>
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.
