diff --git a/source/educators/how-tos/copy_paste_course_content.rst b/source/educators/how-tos/copy_paste_course_content.rst index b7c1b1b2..60172deb 100644 --- a/source/educators/how-tos/copy_paste_course_content.rst +++ b/source/educators/how-tos/copy_paste_course_content.rst @@ -1,6 +1,5 @@ .. _Copy and Paste Course Content: -############################# Copy and Paste Course Content ############################# @@ -16,13 +15,13 @@ Copy and Paste Course Content For instructions on unit-level copy/paste, see :doc:`copy_paste_units` -#. Choose a component that you would like to copy. This may be a text block, a video block or a problem block. +#. Choose a component you would like to copy. This may be a text block, a video block or a problem block. #. In the “actions” hamburger in the upper right corner of the component block, click “Copy to Clipboard”. .. image:: /_images/educator_how_tos/copy_paste_three_dot_menu.png - :alt: A screenshot of the actions hamburger expanded to show the "Copy to Clipboard" option + :alt: A screenshot of the actions hamburger expanded to show the "Copy to Clipboard" option #. A notification will appear in the bottom right-hand side of the screen indicating the copy is complete. It should only take a few seconds. @@ -31,7 +30,7 @@ Copy and Paste Course Content #. Click “paste component”. .. image:: /_images/educator_how_tos/copy_paste_paste_component.png - :alt: A screenshot of the New Unit page showing the new Paste Component button at the bottom + :alt: A screenshot of the New Unit page showing the new Paste Component button at the bottom .. note:: @@ -44,4 +43,5 @@ Copy and Paste Course Content :class: dropdown :ref:`Copy and Paste Course Units ` (how-to) + :ref:`Add Units to the Outline` (how-to) \ No newline at end of file diff --git a/source/educators/how-tos/course_development/add_edit_components.rst b/source/educators/how-tos/course_development/add_edit_components.rst index 3c2ba917..47806ed7 100644 --- a/source/educators/how-tos/course_development/add_edit_components.rst +++ b/source/educators/how-tos/course_development/add_edit_components.rst @@ -1,8 +1,7 @@ .. _Add a Component: -******************** Add a Component -******************** +################# .. tags:: educator, how-to @@ -23,113 +22,11 @@ that you want to work with. After you add a component, it is not visible to learners until you :ref:`publish the unit`. -.. _Edit a Component: +.. seealso:: + :class: dropdown -******************** -Edit a Component -******************** - -To edit a component, you select **Edit** in the component's title bar in -Studio. - -.. image:: /_images/educator_how_tos/unit-edit.png - :alt: A component with the Edit icon indicated in the toolbar. - :width: 400 - -Then, follow instructions for the type of component you are editing. - -After you edit a component, the changes are not visible to learners until you -:ref:`publish the unit`. - -.. _Set the Display Name for a Component: - -===================================== -Set the Display Name for a Component -===================================== - -The display name identifies the component. This name appears as a heading -above the component in the LMS, and it identifies the component for you in -reporting and analytics systems. - -The following illustration shows the display name of a problem in Studio and in -the LMS. - -.. image:: /_images/educator_how_tos/display_names_problem.png - :alt: The identifying display name for a problem in Studio, and the LMS. - :width: 800 - -Unique, descriptive display names help you and your learners identify -components quickly and accurately. - -To set the display name for a component, follow these steps. - -#. Edit the component. A dialog box opens. - - * For a discussion or video component, the dialog box opens to the list of - settings, including the **Display Name** field. - - * For an HTML or problem component, the dialog box opens to an editing view. - Select **Settings** to show the list of settings, including the **Display - Name** field. - -#. Edit the **Display Name** field. - - .. image:: /_images/educator_how_tos/display-name.png - :alt: The settings dialog box for a problem component. - :width: 500 - -#. Select **Save**. - -Different types of components have different fields in the **Settings** dialog -box, but all of them have a **Display Name** field. - - -.. _Duplicate a Component: - -********************** -Duplicate a Component -********************** - -When you duplicate a component, a new copy of that component is added directly -beneath the first component. You can then modify the duplicate. In many cases, -duplicating a component and editing the copy is a faster way to create new -content. - -To duplicate a component, select the **Duplicate** icon in the component -header. - -.. image:: /_images/educator_how_tos/unit-dup.png - :alt: A unit with the Duplicate icon selected and highlighted. - -Then, follow instructions for the type of component you are editing. - -After you duplicate a component, the new component is not visible to learners -until you :ref:`publish the unit`. - -.. note:: Duplicating content experiments after you have configured them is not - supported. - - -.. _Delete a Component: - -********************** -Delete a Component -********************** - -.. caution:: - Be sure you want to delete the component. You cannot undo the deletion. - -To delete a component, follow these steps. - -#. Select the **Delete** icon in the component header. - -.. image:: /_images/educator_how_tos/unit-delete.png - :alt: A unit with the Delete icon circled. - -2. When you receive the confirmation prompt, select **Yes, delete this - component**. - -After you delete a component in Studio, the component remains visible to -learners until you :ref:`publish the unit`. + :ref:`Edit a Component` (how-to) + :ref:`Duplicate a Component` (how-to) + :ref:`Delete a Component` (how-to) diff --git a/source/educators/how-tos/course_development/delete_component.rst b/source/educators/how-tos/course_development/delete_component.rst new file mode 100644 index 00000000..702db82e --- /dev/null +++ b/source/educators/how-tos/course_development/delete_component.rst @@ -0,0 +1,29 @@ +.. _Delete a Component: + +Delete a Component +################## + +.. caution:: + Be sure you want to delete the component. You cannot undo the deletion. + +To delete a component, follow these steps. + +#. Select the **Delete** icon in the component header. + +.. image:: /_images/educator_how_tos/unit-delete.png + :alt: A unit with the Delete icon circled. + +2. When you receive the confirmation prompt, select **Yes, delete this + component**. + +After you delete a component in Studio, the component remains visible to +learners until you :ref:`publish the unit`. + +.. seealso:: + :class: dropdown + + :ref:`Edit a Component` (how-to) + + :ref:`Duplicate a Component` (how-to) + + :ref:`Add a Component` (how-to) diff --git a/source/educators/how-tos/course_development/duplicate_component.rst b/source/educators/how-tos/course_development/duplicate_component.rst new file mode 100644 index 00000000..b4aeadce --- /dev/null +++ b/source/educators/how-tos/course_development/duplicate_component.rst @@ -0,0 +1,32 @@ +.. _Duplicate a Component: + +Duplicate a Component +##################### + +When you duplicate a component, a new copy of that component is added directly +beneath the first component. You can then modify the duplicate. In many cases, +duplicating a component and editing the copy is a faster way to create new +content. + +To duplicate a component, select the **Duplicate** icon in the component +header. + +.. image:: /_images/educator_how_tos/unit-dup.png + :alt: A unit with the Duplicate icon selected and highlighted. + +Then, follow instructions for the type of component you are editing. + +After you duplicate a component, the new component is not visible to learners +until you :ref:`publish the unit`. + +.. note:: Duplicating content experiments after you have configured them is not + supported. + +.. seealso:: + :class: dropdown + + :ref:`Edit a Component` (how-to) + + :ref:`Add a Component` (how-to) + + :ref:`Delete a Component` (how-to) diff --git a/source/educators/how-tos/course_development/edit_component.rst b/source/educators/how-tos/course_development/edit_component.rst new file mode 100644 index 00000000..fca2c368 --- /dev/null +++ b/source/educators/how-tos/course_development/edit_component.rst @@ -0,0 +1,66 @@ +.. _Edit a Component: + +Edit a Component +################ + +To edit a component, you select **Edit** in the component's title bar in +Studio. + +.. image:: /_images/educator_how_tos/unit-edit.png + :alt: A component with the Edit icon indicated in the toolbar. + :width: 400 + +Then, follow instructions for the type of component you are editing. + +After you edit a component, the changes are not visible to learners until you +:ref:`publish the unit`. + +.. _Set the Display Name for a Component: + +Set the Display Name for a Component +************************************ + +The display name identifies the component. This name appears as a heading +above the component in the LMS, and it identifies the component for you in +reporting and analytics systems. + +The following illustration shows the display name of a problem in Studio and in +the LMS. + +.. image:: /_images/educator_how_tos/display_names_problem.png + :alt: The identifying display name for a problem in Studio, and the LMS. + :width: 800 + +Unique, descriptive display names help you and your learners identify +components quickly and accurately. + +To set the display name for a component, follow these steps. + +#. Edit the component; a dialog box opens. + + * For a discussion or video component, the dialog box opens to the list of + settings, including the **Display Name** field. + + * For an HTML or problem component, the dialog box opens to an editing view. + Select **Settings** to show the list of settings, including the **Display + Name** field. + +#. Edit the **Display Name** field. + + .. image:: /_images/educator_how_tos/display-name.png + :alt: The settings dialog box for a problem component. + :width: 500 + +#. Select **Save**. + +Different types of components have different fields in the **Settings** dialog +box, but all of them have a **Display Name** field. + +.. seealso:: + :class: dropdown + + :ref:`Add a Component` (how-to) + + :ref:`Duplicate a Component` (how-to) + + :ref:`Delete a Component` (how-to) \ No newline at end of file diff --git a/source/educators/how-tos/course_development/exercise_tools/add_qualtrics_survey.rst b/source/educators/how-tos/course_development/exercise_tools/add_qualtrics_survey.rst index 3c66cfd1..cd1c6baa 100644 --- a/source/educators/how-tos/course_development/exercise_tools/add_qualtrics_survey.rst +++ b/source/educators/how-tos/course_development/exercise_tools/add_qualtrics_survey.rst @@ -1,12 +1,11 @@ .. _Qualtrics Survey: -######################### Qualtrics Survey Tool ######################### .. tags:: educator, how-to -You can administer Qualtrics surveys to your learners in your edX course. The +You can administer Qualtrics surveys to your learners in your Open edX course. The Qualtrics survey appears in an iframe inside the course. .. image:: /_images/educator_how_tos/Qualtrics.png @@ -19,7 +18,7 @@ from individual learners. .. note:: To use a Qualtrics survey, you must have a Qualtrics license. Qualtrics licenses are available for a fee at the `Qualtrics website `_. If you want to include a survey but you do not - have a Qualtrics license, you can use the :ref:`edX survey tool` + have a Qualtrics license, you can use the :ref:`Open edX survey tool` or a :ref:`Google form`. For more information, see the following sections. @@ -33,7 +32,6 @@ accessible before making them available through your course. For more information, see :ref:`Accessibility Best Practices for Course Content Development`. -************************************* Add a Qualtrics Survey to Your Course ************************************* @@ -52,7 +50,7 @@ Create the Qualtrics Survey `_ for the most up-to-date Qualtrics documentation. #. Using your Qualtrics account, create your survey. -#. Add the statements and options that you want the survey to include. +#. Add the statements and options you want the survey to include. #. Add the **user ID** element. This element imports data from your course into Qualtrics. @@ -108,7 +106,7 @@ Create the Text Component in Studio * Replace the values in the ``width`` and ``height`` attributes with values that allow your survey to appear the way you want it to. For example, you might change ``width`` to 800 and ``height`` to 1000. - * (Optional) If your survey might be taller than the value that you set for + * (Optional) If your survey might be taller than the value you set for ``height``, in the ``scrolling`` attribute, change the value to ``yes``. If you do not change the value to ``yes`` and your survey is taller than the ``height`` value, learners cannot scroll down to respond to all the diff --git a/source/educators/how-tos/course_development/exercise_tools/add_scorm_xblock.rst b/source/educators/how-tos/course_development/exercise_tools/add_scorm_xblock.rst index 5bb1e8c7..61f36cb9 100644 --- a/source/educators/how-tos/course_development/exercise_tools/add_scorm_xblock.rst +++ b/source/educators/how-tos/course_development/exercise_tools/add_scorm_xblock.rst @@ -1,6 +1,5 @@ .. _SCORM XBlock: -###### SCORM ###### @@ -8,8 +7,6 @@ SCORM This section describes how to include `SCORM `_ content in your course. - -*********************** Enable the SCORM XBlock *********************** @@ -23,39 +20,38 @@ include the quotation marks around the key value.) For more information, see .. image:: /_images/educator_how_tos/AdvancedModuleListScorm.png :alt: Advanced Module List with "scorm" added. -********************************** 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. -.. image:: /_images/educator_how_tos/AddNewAdvancedComponent.png - :alt: Add New Advanced Component + .. image:: /_images/educator_how_tos/AddNewAdvancedComponent.png + :alt: Add New Advanced Component -* Select ``Scorm module`` +#. Select ``Scorm module`` -.. image:: /_images/educator_how_tos/AddScormModule.png - :alt: Select Scorm module + .. image:: /_images/educator_how_tos/AddScormModule.png + :alt: Select Scorm module -* ``Scorm module`` selected +#. ``Scorm module`` selected -.. image:: /_images/educator_how_tos/AddScormModuleSelected.png - :alt: Selected Scorm module + .. image:: /_images/educator_how_tos/AddScormModuleSelected.png + :alt: Selected Scorm module -* The SCORM module component will be added. Click on the **EDIT** button. +#. The SCORM module component will be added. Click on the **EDIT** button. -.. image:: /_images/educator_how_tos/ScormBlockStudio.png - :alt: New SCORM Component in Studio + .. image:: /_images/educator_how_tos/ScormBlockStudio.png + :alt: New SCORM Component in Studio + -*************************** Uploading the SCORM content *************************** @@ -64,9 +60,9 @@ Uploading the SCORM content -* Choose the SCORM .zip package you want to upload. -* If the SCORM content does not have any quizzes, set “Scored” to False. -* If the "Scored" parameter is True, you must specify the weight of the quizzes' points. +#. Choose the SCORM .zip package you want to upload. +#. If the SCORM content does not have any quizzes, set “Scored” to False. +#. 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. diff --git a/source/educators/how-tos/course_development/exercise_tools/embed_google_drive.rst b/source/educators/how-tos/course_development/exercise_tools/embed_google_drive.rst index 2f733ce9..055af946 100644 --- a/source/educators/how-tos/course_development/exercise_tools/embed_google_drive.rst +++ b/source/educators/how-tos/course_development/exercise_tools/embed_google_drive.rst @@ -1,8 +1,7 @@ .. _Embed Google Drive Files: -******************************************** Embedding a Google Drive File in Your Course -******************************************** +############################################## .. tags:: educator, how-to @@ -14,9 +13,8 @@ To embed a Google Drive file in your course, follow these steps. .. _Enable the Google Drive Files Tool: -================================================== Enable the Google Drive Files Tool -================================================== +*********************************** Before you can add Google Drive files to your course, you must enable the Google Drive tool in Studio or OLX (open learning XML). @@ -48,14 +46,10 @@ also enables Google calendars. ... -For more information, see `OLX Course Building Blocks`_ in the -*EdX Open Learning XML Guide*. - .. _Obtain the Google Drive File Embed Code: -======================================================= Publish the Google Drive File and Obtain the Embed Code -======================================================= +******************************************************** Before you can add a Google Drive file to your course, you must publish the file to the web and obtain the embed code for the file. diff --git a/source/educators/how-tos/course_development/reorganize_components.rst b/source/educators/how-tos/course_development/reorganize_components.rst index 3ace1330..bbadda06 100644 --- a/source/educators/how-tos/course_development/reorganize_components.rst +++ b/source/educators/how-tos/course_development/reorganize_components.rst @@ -1,9 +1,7 @@ - .. _Reorganizing Components: -****************************************** Reorganizing Components -****************************************** +########################### .. tags:: educator, how-to @@ -14,12 +12,11 @@ or you can move components from one unit to another unit. :local: :depth: 1 -====================================== Reorganize Components Within a Unit -====================================== +***************************************** To reorganize components within their current unit, you drag and drop -components in the same way that you can drag and drop units, subsections, and +components in the same way you can drag and drop units, subsections, and sections on the **Course Outline** page. For more information, see :ref:`Reorganize the Course Outline`. @@ -39,13 +36,13 @@ you are moving appears in the new location. You can also drag a child component outside of a parent, so that the child moves to the same level as the parent. -================================ + Move Components to Other Units -================================ +******************************** To move components to another unit in the course outline, follow these steps. -#. Select the **Move** icon for the component that you want to move. +#. Select the **Move** icon for the component you want to move. .. image:: /_images/educator_how_tos/component_move_icon.png :alt: The action icons for components, with the Move icon highlighted. @@ -58,7 +55,7 @@ To move components to another unit in the course outline, follow these steps. .. image:: /_images/educator_how_tos/component_move_navigation.png :alt: The Move dialog box displays your course outline tree for - navigating to the unit that you want to move your component to. + navigating to the unit you want to move your component to. :width: 380 The **Move** button is enabled only when your selected location is a valid @@ -73,6 +70,17 @@ To move components to another unit in the course outline, follow these steps. .. note:: - If the old and new locations of the component that you moved were + If the old and new locations of the component you moved were previously published, your changes are not reflected in the learner's view of the course until you republish the affected units. + +.. seealso:: + :class:dropdown + + :ref:`Add a Component` (how-to) + + :ref:`Edit a Component` (how-to) + + :ref:`Duplicate a Component` (how-to) + + :ref:`Delete a Component` (how-to) \ No newline at end of file diff --git a/source/educators/navigation/content_creation_management.rst b/source/educators/navigation/content_creation_management.rst index 390e7262..97e5c4e8 100644 --- a/source/educators/navigation/content_creation_management.rst +++ b/source/educators/navigation/content_creation_management.rst @@ -35,6 +35,9 @@ Create and Manage Components ../how-tos/course_development/set_component_restrictions.rst ../how-tos/course_development/reorganize_components.rst ../references/course_development/parent_child_components.rst + ../how-tos/course_development/edit_component.rst + ../how-tos/course_development/duplicate_component.rst + ../how-tos/course_development/delete_component.rst .. _Add Text Components: