summaryrefslogtreecommitdiff
path: root/lib/spack/docs/tutorial.rst
diff options
context:
space:
mode:
Diffstat (limited to 'lib/spack/docs/tutorial.rst')
-rw-r--r--lib/spack/docs/tutorial.rst54
1 files changed, 54 insertions, 0 deletions
diff --git a/lib/spack/docs/tutorial.rst b/lib/spack/docs/tutorial.rst
new file mode 100644
index 0000000000..ff2a2f6870
--- /dev/null
+++ b/lib/spack/docs/tutorial.rst
@@ -0,0 +1,54 @@
+.. _spack-101:
+
+=============================
+Tutorial: Spack 101
+=============================
+
+This is a 3-hour introduction to Spack with lectures and live demos. It
+was presented as a tutorial at `Supercomputing 2016
+<http://sc16.supercomputing.org>`_. You can use these materials to teach
+a course on Spack at your own site, or you can just skip ahead and read
+the live demo scripts to see how Spack is used in practice.
+
+.. _sc16-slides:
+
+.. rubric:: Slides
+
+.. figure:: tutorial/sc16-tutorial-slide-preview.png
+ :target: http://llnl.github.io/spack/files/Spack-SC16-Tutorial.pdf
+ :height: 72px
+ :align: left
+ :alt: Slide Preview
+
+`Download Slides <http://llnl.github.io/spack/files/Spack-SC16-Tutorial.pdf>`_.
+
+**Full citation:** Todd Gamblin, Massimiliano Culpo, Gregory Becker, Matt
+Legendre, Greg Lee, Elizabeth Fischer, and Benedikt Hegner.
+`Managing HPC Software Complexity with Spack
+<http://sc16.supercomputing.org/presentation/?id=tut166&sess=sess209>`_.
+Tutorial presented at Supercomputing 2016. November 13, 2016, Salt Lake
+City, UT, USA.
+
+.. _sc16-live-demos:
+
+.. rubric:: Live Demos
+
+These scripts will take you step-by-step through basic Spack tasks. They
+correspond to sections in the slides above.
+
+ 1. :ref:`basics-tutorial`
+ 2. :ref:`configs-tutorial`
+ 3. :ref:`packaging-tutorial`
+ 4. :ref:`build-systems-tutorial`
+ 5. :ref:`advanced-packaging-tutorial`
+ 6. :ref:`modules-tutorial`
+
+Full contents:
+
+.. toctree::
+ tutorial_basics
+ tutorial_configuration
+ tutorial_packaging
+ tutorial_buildsystems
+ tutorial_advanced_packaging
+ tutorial_modules