Merge pull request #2161 from graemeglass/master

Update the SCORM documentation. Add in extra image for selection step.

en_us/shared/exercises_tools/scorm.rst

@@ -4,7 +4,7 @@
 SCORM
 ##################
 
-.. note:: EdX offers full support for this tool.
+.. note:: EdX offers full support for this tool via edx.org. The SCORM XBlock is not supported on the edX mobile app.
 
 This section describes how to include `SCORM <https://en.wikipedia.org/wiki/Sharable_Content_Object_Reference_Model>`_ content in your course.
 
@@ -16,7 +16,7 @@ This section describes how to include `SCORM <https://en.wikipedia.org/wiki/Shar
 Overview
 ***********
 
-The SCORM XBlock provides the ability to display SCORM content within the Open edX LMS and Studio.
+The SCORM `XBlock <https://edx.readthedocs.io/projects/xblock-tutorial/en/latest/overview/introduction.html>`_ provides the ability to display SCORM content within the Open edX LMS and Studio.
 It can save a learners state and report scores to the progress tab of the course.
 It currently supports SCORM 1.2 and SCORM 2004 standard.
 
@@ -38,7 +38,7 @@ include the quotation marks around the key value.) For more information, see
 Adding a SCORM component to a Unit
 **************************************************
 
-* In a unit where you want the SCORM content to display, click on the “Advanced” Icon.
+* In a unit where you want the SCORM content to display, click on the ``Advanced`` Icon.
 
 
 .. figure:: ../../../shared/images/AddNewAdvancedComponent.png
@@ -53,6 +53,11 @@ Adding a SCORM component to a Unit
   :alt: Select Scorm module
 
 
+* ``Scorm module`` selected
+
+.. figure:: ../../../shared/images/AddScormModuleSelected.png
+  :alt: Selected Scorm module
+
 
 * The SCORM module component will be added. Click on the **EDIT** button.
 
@@ -75,7 +80,22 @@ Uploading the SCORM content
 * If the "Scored" parameter is True, you must specify the weight of the quizzes' points.
 
 
-.. note:: Only 1 SCORM component per Unit may be used. The component will be displayed under the **Units** title in the LMS. The Display Name is only used within Studio.
+.. note:: * Only 1 SCORM component per Unit may be used.
+          * The SCORM component will be displayed under the **Unit** title in the LMS.
+          * The **Display Name** is only used within Studio.
+
+
+**************************************************
+SCORM Content best practise
+**************************************************
+
+To ensure the best experience for learners it is recommend that you keep your SCORM packages small. (1MB - 15MB)
+A larger package has a longer load time and can cause a bad learner experience.
+
+Following the rule of 1 SCORM component per unit, it is recommended that you break your content up into unit sized chunks.
+This will help maintain the smaller package size.
+
+Try to limit the SCORM package to 1 quiz or scored component.
 
 
 **************************************************