diff --git a/lib/spack/docs/basic_usage.rst b/lib/spack/docs/basic_usage.rst
index 03e6d581a48b419b661fe0d8219391784d466f5d..12f48dde4e6806cfbdc5f9f193122645e3748868 100644
--- a/lib/spack/docs/basic_usage.rst
+++ b/lib/spack/docs/basic_usage.rst
@@ -838,8 +838,6 @@ add a version specifier to the spec:
 Notice that the package versions that provide insufficient MPI
 versions are now filtered out.
 
-.. _shell-support:
-
 ---------------------------
 Extensions & Python support
 ---------------------------
diff --git a/lib/spack/docs/getting_started.rst b/lib/spack/docs/getting_started.rst
index 34cbf453e1514cd6250a3c3418558134c06ed626..6ec55cca48690cfcc420f52689f9eec26ffc397a 100644
--- a/lib/spack/docs/getting_started.rst
+++ b/lib/spack/docs/getting_started.rst
@@ -47,8 +47,7 @@ to your path and you're ready to go:
    $ export PATH=$SPACK_ROOT/bin:$PATH
    $ spack install libelf
 
-For a richer experience, use Spack's `shell support
-<http://software.llnl.gov/spack/basic_usage.html#environment-modules>`_:
+For a richer experience, use Spack's shell support:
 
 .. code-block:: console
 
@@ -60,7 +59,9 @@ For a richer experience, use Spack's `shell support
    $ setenv SPACK_ROOT /path/to/spack
    $ source $SPACK_ROOT/share/spack/setup-env.csh
 
-This automatically adds Spack to your ``PATH``.
+This automatically adds Spack to your ``PATH`` and allows the ``spack``
+command to :ref:`load environment modules <shell-support>` and execute
+:ref:`useful packaging commands <packaging-shell-support>`.
 
 ^^^^^^^^^^^^^^^^^
 Clean Environment
diff --git a/lib/spack/docs/module_file_support.rst b/lib/spack/docs/module_file_support.rst
index f07bd31c2e17eaeff35e83a721ce24937596274d..0daa9232ede7182bee30b8c67067bfd82581a639 100644
--- a/lib/spack/docs/module_file_support.rst
+++ b/lib/spack/docs/module_file_support.rst
@@ -24,7 +24,7 @@ directly with automatically generated module files.
    we advise you to use either Environment Modules or LMod. See :ref:`InstallEnvironmentModules`
    for more details.
 
-.. _shell_support:
+.. _shell-support:
 
 -------------
 Shell support
diff --git a/lib/spack/docs/packaging_guide.rst b/lib/spack/docs/packaging_guide.rst
index a22fcd71bae7530d4b1f122c93a9b31a4297d64a..aa9a3874bb15f8245b7dc4f0b73c79922c3e5899 100644
--- a/lib/spack/docs/packaging_guide.rst
+++ b/lib/spack/docs/packaging_guide.rst
@@ -3120,6 +3120,8 @@ example:
 This graph can be provided as input to other graphing tools, such as
 those in `Graphviz <http://www.graphviz.org>`_.
 
+.. _packaging-shell-support:
+
 -------------------------
 Interactive shell support
 -------------------------
diff --git a/lib/spack/docs/tutorial_sc16.rst b/lib/spack/docs/tutorial_sc16.rst
index 6fa630c57ba3749cc7476ef9fac29315dc6b92f9..39d602bda0d610121efe74a618311339fdf97b46 100644
--- a/lib/spack/docs/tutorial_sc16.rst
+++ b/lib/spack/docs/tutorial_sc16.rst
@@ -15,12 +15,12 @@ the live demo scripts to see how Spack is used in practice.
 .. rubric:: Slides
 
 .. figure:: tutorial/sc16-tutorial-slide-preview.png
-   :target: http://software.llnl.gov/spack/files/Spack-SC16-Tutorial.pdf
+   :target: http://llnl.github.io/spack/files/Spack-SC16-Tutorial.pdf
    :height: 72px
    :align: left
    :alt: Slide Preview
 
-`Download Slides <software.llnl.gov/spack/files/Spack-SC16-Tutorial.pdf>`_.
+`Download Slides <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.
diff --git a/lib/spack/docs/tutorial_sc16_modules.rst b/lib/spack/docs/tutorial_sc16_modules.rst
index 1e786674bb0e9484404155d10713b832a4f0f84d..00684223cd809fab5d6a688b63d4bb72a43670b2 100644
--- a/lib/spack/docs/tutorial_sc16_modules.rst
+++ b/lib/spack/docs/tutorial_sc16_modules.rst
@@ -34,7 +34,7 @@ Prerequisites
 Before proceeding further ensure:
 
 - you have LMod or Environment Modules available
-- have :ref:`shell support <shell_support>` activated in Spack
+- have :ref:`shell support <shell-support>` activated in Spack
 
 If you need to install Lmod or Environment module you can refer
 to the documentation :ref:`here <InstallEnvironmentModules>`.