{{{#!rst

Sage Days 45 Tutorials
======================

Tutorial I: Using the Sage notebook and navigating the help system
------------------------------------------------------------------

 Leader: Franco Saliola

 Worksheet: We will be starting with a blank worksheet, but here is a worksheet that can be used for self-study.

 - `Using the Sage Notebook and navigating the help system`_
   (here is the `html version`__ of this worksheet)

   __ http://combinat.sagemath.org/doc/thematic_tutorials/tutorial-notebook-and-help-long.html

 Resources:

 - `Sage Quick Reference Card`_
 - `The Sage tutorial`_
 - `The Sage thematic tutorials <http://combinat.sagemath.org/doc/thematic_tutorials>`_
 - `Sage Constructions`_: "How do I construct ... in Sage?"
 - `Sage documentation`_: the standard documentation and other resources
 - `Calcul mathématique avec Sage`_

.. _`Sage Quick Reference Card`: http://wiki.sagemath.org/quickref?action=AttachFile&do=get&target=quickref.pdf
.. _`The Sage tutorial`: http://www.sagemath.org/doc/tutorial
.. _`Sage Constructions`: http://sagemath.org/doc/constructions
.. _`Sage documentation`: http://sagemath.org/help.html#SageStandardDoc
.. _`Calcul mathématique avec Sage`: http://sagebook.gforge.inria.fr/

 Post-tutorial Updates:

 - `Final worksheet from today's tutorial`__ (and the `pdf version`__)
 - link to the `trac ticket #14094`_ for the bug we found in Sage during the tutorial
 
 __ http://wiki.sagemath.org/days45_tutorials?action=AttachFile&do=get&target=FirstWorksheetAtICERM.sws
 __ http://wiki.sagemath.org/days45_tutorials?action=AttachFile&do=get&target=FirstWorksheetAtICERM.pdf
 .. _`trac ticket #14094`: http://trac.sagemath.org/sage_trac/ticket/14094



See also the `tutorials page`__ from Sage Days 38.

__ days38_tutorials

Sharing worksheets with the windows VirtualBox appliance
--------------------------------------------------------

If the virtual appliance is started, follow `section 4`_ of `the sage appliance wiki`_.

.. _`section 4`: http://wiki.sagemath.org/SageAppliance#Sharing_files_between_Sage_and_Windows
.. _`the sage appliance wiki`: http://wiki.sagemath.org/SageAppliance

Otherwise follow these steps:

1. Highlight the sage appliance and select **Settings**.

2. Under the settings, navigate to the **shared folders** options and follow `the above directions`_ starting at step #3.

.. _`the above directions`: http://wiki.sagemath.org/SageAppliance#Sharing_files_between_Sage_and_Windows


Tutorial: Introduction to Version Control
-----------------------------------------

 Leader: Vincent Delecroix featuring Franco Saliola

 Mercurial resources:

 - `Hg Init: a Mercurial Tutorial`_. In this user-friendly, six-part tutorial, Joel Spolsky teaches you the key concepts of Mercurial.
 - `Learning Mercurial in Workflows`_. This page illustrates the use of Mercurial in various workflows.
 - `Mq Tutorial`_. A tutorial on Mercurial queues.
 - `A Git User’s Guide to Mercurial Queues`_

.. _`Hg Init: a Mercurial Tutorial`: http://hginit.com/
.. _`Learning Mercurial in Workflows`: http://mercurial.selenic.com/guide
.. _`Mq Tutorial`: http://mercurial.selenic.com/wiki/MqTutorial
.. _`A Git User’s Guide to Mercurial Queues`: http://stevelosh.com/blog/2010/08/a-git-users-guide-to-mercurial-queues/


Tutorial IV: Contributing to Sage
---------------------------------

 Leader: Chris Berg featuring Franco Saliola

 Guides:

 - `How to Referee Sage Trac Tickets`_ by William Stein
 - `How to contribute to Sage`_ by Sébastien Labbé
 - `Introduction to Sage Development`_ by Mike Hansen
 - `Short step-by-step checklist for reviewing a patch`_ by Franco Saliola
 - `Sage Developer's Guide`_:

   - `Walking Through the Development Process`_
   - `Review a patch`_

 Videos:

 - `Contributing to Sage : Who, What and How`_: video of a talk by William Stein

 Related thematic tutorials:

 - `Editing the Sage sources`_

 ReStructuredText resources:

 - `Quick reStructuredText`_: quick reference for reStructuredText
 - `reStructuredText`_: more detailed reference
 - `reStructuredText (saifoo.net)`_

.. _`How to contribute to Sage`: http://thales.math.uqam.ca/~labbes/Sage/how-to-contribute/
.. _`How to Referee Sage Trac Tickets`: http://sagemath.blogspot.com/2010/10/how-to-referee-sage-trac-tickets.html
.. _`Editing the Sage sources`: http://combinat.sagemath.org/doc/thematic_tutorials/tutorial-editing-sage-sources.html
.. _`Introduction to Sage Development`: http://wiki.sagemath.org/days20.5/schedule?action=AttachFile&do=view&target=sd20.5.pdf
.. _`Short step-by-step checklist for reviewing a patch`: https://www.evernote.com/shard/s16/sh/f30e5eb9-70a9-4882-818b-333c690942bf/d7a138e2705c25b8da6e2053950a89d5
.. _`Sage Developer's Guide`: http://sagemath.org/doc/developer/index.html
.. _`Walking Through the Development Process`: http://sagemath.org/doc/developer/walk_through.html
.. _`Review a patch`: http://sagemath.org/doc/developer/walk_through.html#reviewing-a-patch
.. _`Contributing to Sage : Who, What and How`: http://vimeo.com/14044496

.. _`Quick reStructuredText`: http://docutils.sourceforge.net/docs/user/rst/quickref.html
.. _`reStructuredText`: http://docutils.sourceforge.net/rst.html
.. _`Sphinx Markup Constructs`: http://sphinx.pocoo.org/markup/index.html
.. _`reStructuredText (saifoo.net)`: http://www.siafoo.net/help/reST/
.. _`ReText`: http://sourceforge.net/p/retext/home/ReText


}}}