diff --git a/source/educators/how-tos/course_development/exercise_tools/add_word_cloud.rst b/source/educators/how-tos/course_development/exercise_tools/add_word_cloud.rst index a7e4df31..8cb74cd8 100644 --- a/source/educators/how-tos/course_development/exercise_tools/add_word_cloud.rst +++ b/source/educators/how-tos/course_development/exercise_tools/add_word_cloud.rst @@ -78,4 +78,9 @@ To create a word cloud, follow these steps. frequency that each of their own contributed words has been entered is shown as a percentage of all words entered. -#. Select **Save**. \ No newline at end of file +#. Select **Save**. + +.. seealso:: + :class:dropdown + + :ref:`Create Exercises` (concepts) \ No newline at end of file diff --git a/source/educators/how-tos/course_development/exercise_tools/create_poll_olx.rst b/source/educators/how-tos/course_development/exercise_tools/create_poll_olx.rst new file mode 100644 index 00000000..a2113557 --- /dev/null +++ b/source/educators/how-tos/course_development/exercise_tools/create_poll_olx.rst @@ -0,0 +1,106 @@ +.. _Create a Poll: + +Create a Poll for OLX +######################## + +.. tags:: educator, how-to + +#. In the unit where you want to create the poll, create components that + contain all the content that you want *except* for the poll. Make a note of + the 32-digit unit ID that appears in the **Unit Identifier** field under + **Unit Location**. + +#. Export your course. For information about how to do this, see + :ref:`Export a Course`. Save the .tar.gz file that contains + your course in a memorable location so that you can find it easily. + +#. Locate the .tar.gz file that contains your course, and then unpack the + .tar.gz file so that you can see its contents in a list of folders and + files. + + - To do this on a Windows computer, you need to download a third-party + program. For more information, see `How to Unpack a tar File in Windows + `_, + `How to Extract a Gz File `_, + `The gzip Home Page `_, or the `Windows + `_ + section of the `How to Open .tar.gz Files + `_ page. + + - For information about how to do this on a Mac, see the `Mac OS X `_ section of the `How to Open .tar.gz Files `_ page. + +#. In the list of folders and files, open the **Vertical** folder. + + .. note:: If your unit is not published, open the **Drafts** folder, and then open the **Vertical** folder in the **Drafts** folder. + +#. In the **Vertical** folder, locate the .xml file that has the same name as + the unit ID that you noted in step 1, and then open the file in a text + editor such as Sublime 2. For example, if the unit ID is + e461de7fe2b84ebeabe1a97683360d31, you open the + e461de7fe2b84ebeabe1a97683360d31.xml file. + + The file contains a list of all the components in the unit, together with + the URL names of the components. For example, the following file contains an + Text component followed by a discussion component. + + .. code-block:: xml + + + + + + +#. Add the following poll code in the location where you want the poll. Change + the text of the prompt to the text that you want. + + .. code-block:: xml + + +

Text of the prompt

+ Yes + No + + + In the example above, if you wanted your poll to appear between the HTML + component and the discussion component in the unit, your code would resemble + the following. + + .. code-block:: xml + + + + +

Text of the prompt

+ Yes + No + + + + +#. After you add the poll code, save and close the .xml file. + +#. Re-package your course as a .tar.gz file. + +#. In Studio, re-import your course. You can now review the poll question and + answers that you added in Studio. + +.. note:: + + * Although polls render correctly in Studio, you cannot edit them in Studio. + You will need to follow the export/import process outlined above to make + any edits to your polls. + + * A .csv file that contains student responses to the problem is not currently + available for polls. However, you can obtain the aggregate data directly in + the problem. + +.. seealso:: + :class: dropdown + + :ref:`Poll Tool for OLX` (reference) + + :ref:`Poll Tool` (reference) + + :ref:`Add Poll` (how to) + + :ref:`Enable Poll in OLX` (reference) diff --git a/source/educators/how-tos/course_development/exercise_tools/download_data_instructor_dashboard.rst b/source/educators/how-tos/course_development/exercise_tools/download_data_instructor_dashboard.rst new file mode 100644 index 00000000..293c1e0c --- /dev/null +++ b/source/educators/how-tos/course_development/exercise_tools/download_data_instructor_dashboard.rst @@ -0,0 +1,47 @@ +.. _Download Data from the Instructor Dashboard: + +Download Data from the Instructor Dashboard +############################################## + +.. tags:: educator, how-to + +#. In the LMS, select **Instructor**. +#. Select **Data Download**. +#. Under **Data Download**, select **Get Student Anonymized IDs CSV**. If you + receive a prompt, specify the location where you want to save the file. + + The .csv file is saved to your computer. The file has the following name. + + ``____anon-ids.csv`` + + For more information about anonymized student IDs, see + :ref:`Access_anonymized`. + +#. Under **Reports**, select **Download profile information as a CSV**. +#. When the profile information report appears in the list under **Reports + Available for Download**, select the report to download the .csv file to + your computer. The file has the following name. + + ``____student_profile_info_.csv`` + +For more information about accessing learner data, see :ref:`Learner Data`. + +Download Data from Qualtrics +******************************* + +.. note:: Because Qualtrics is a third-party tool, the following steps might + change without notice. See the `Qualtrics website + `_ for the most up-to-date Qualtrics documentation. + +#. In Qualtrics, select the **View Results** tab. +#. On the page that opens, select **Download Data** in the upper left corner + of the page. +#. On the page that opens, clear the **Compress the desired format into a .zip + file before downloading** check box. Accept all the other default values. +#. Under **Format**, select the **This is a Comma + Separated Values format...** link to download the .csv file. + +.. seealso:: + :class: dropdown + + :ref:`Qualtrics Survey` (how to) diff --git a/source/educators/how-tos/sidebar_collapse_expand.rst b/source/educators/how-tos/sidebar_collapse_expand.rst index 6f2b4d99..7a693bda 100644 --- a/source/educators/how-tos/sidebar_collapse_expand.rst +++ b/source/educators/how-tos/sidebar_collapse_expand.rst @@ -1,3 +1,5 @@ +.. _Collapse and expand the navigation sidebar: + Collapse and expand the navigation sidebar ########################################## @@ -16,3 +18,12 @@ of the page: As the learner advances through the course content, the expanded or collapsed state of the sidebar remains consistent. + +.. seealso:: + :class:dropdown + + :ref:`What is LMS` (concept) + + :ref:`What is Studio` (concept) + + :ref:`Course Outline` (concept) \ No newline at end of file diff --git a/source/educators/how-tos/sidebar_view_course_section.rst b/source/educators/how-tos/sidebar_view_course_section.rst index 274ea55e..74a67317 100644 --- a/source/educators/how-tos/sidebar_view_course_section.rst +++ b/source/educators/how-tos/sidebar_view_course_section.rst @@ -1,4 +1,4 @@ -View course sections from the navigation sidebar +View Course Sections from the Navigation Sidebar ################################################ .. tags:: educator, how-to @@ -18,4 +18,13 @@ Clicking on any section: brings you to a view of the contents of that section, regardless of where you are in the course at the moment: - .. image:: /_images/educator_how_tos/LSN_view_sections_step2b.png \ No newline at end of file + .. image:: /_images/educator_how_tos/LSN_view_sections_step2b.png + +.. seealso:: + :class:dropdown + + :ref:`What is LMS` (concept) + + :ref:`What is Studio` (concept) + + :ref:`Course Outline` (concept) \ No newline at end of file diff --git a/source/educators/navigation/learner_engagement_communication.rst b/source/educators/navigation/learner_engagement_communication.rst index 443644b6..bacb99d2 100644 --- a/source/educators/navigation/learner_engagement_communication.rst +++ b/source/educators/navigation/learner_engagement_communication.rst @@ -132,6 +132,7 @@ Poll Tool ../references/course_development/exercise_tools/poll_olx.rst ../references/course_development/exercise_tools/enable_poll_OLX.rst + ../how-tos/course_development/exercise_tools/create_poll_olx.rst Survey Tool @@ -154,6 +155,7 @@ Qualtrics Survey Tool ../how-tos/course_development/exercise_tools/add_qualtrics_survey.rst ../references/course_development/exercise_tools/view_qualtrics_responses.rst + ../how-tos/course_development/exercise_tools/download_data_instructor_dashboard.rst @@ -164,4 +166,4 @@ Word Cloud Tool :maxdepth: 2 :glob: - ../how-tos/course_development/exercise_tools/add_word_cloud.rst \ No newline at end of file + ../how-tos/course_development/exercise_tools/add_word_cloud.rst diff --git a/source/educators/references/course_development/exercise_tools/enable_poll_OLX.rst b/source/educators/references/course_development/exercise_tools/enable_poll_OLX.rst index 804339c2..1225cdf8 100644 --- a/source/educators/references/course_development/exercise_tools/enable_poll_OLX.rst +++ b/source/educators/references/course_development/exercise_tools/enable_poll_OLX.rst @@ -1,13 +1,12 @@ -Alternatively, you can use OLX to enable the poll tool. - .. _Enable Poll in OLX: -====================================== Enable the Poll Tool in OLX -====================================== +############################ .. tags:: educator, reference +.. note:: Alternatively, you can use OLX to enable the poll tool. + To enable polls in your course, you edit the XML file that defines the course structure. diff --git a/source/educators/references/course_development/exercise_tools/enable_survey_olx.rst b/source/educators/references/course_development/exercise_tools/enable_survey_olx.rst index 46a425b6..407258af 100644 --- a/source/educators/references/course_development/exercise_tools/enable_survey_olx.rst +++ b/source/educators/references/course_development/exercise_tools/enable_survey_olx.rst @@ -1,8 +1,7 @@ .. _Enable Survey OLX: -====================================== Enable the Survey Tool in OLX -====================================== +################################ .. tags:: educator, reference @@ -22,7 +21,6 @@ For example, the following XML code enables the survey tool. ... -*************************** Add a Survey in OLX *************************** @@ -69,9 +67,9 @@ The following example shows the OLX definition for a survey with two questions. ]" /> -========================== + survey Element Attributes -========================== +************************** The following table describes the attribute of the ``survey`` element. diff --git a/source/educators/references/course_development/exercise_tools/google_calendar.rst b/source/educators/references/course_development/exercise_tools/google_calendar.rst index 84c3c830..5a21fca9 100644 --- a/source/educators/references/course_development/exercise_tools/google_calendar.rst +++ b/source/educators/references/course_development/exercise_tools/google_calendar.rst @@ -24,7 +24,7 @@ Tool`. .. note:: Google services are not available in some regions and countries. If Google services are not available in a learner's area, the learner might see an "image unavailable" message in the place of the Google Drive file or - Google Calendar. EdX strongly suggests that you provide alternative resources + Google Calendar. The recommendation is to provide alternative resources for learners in these areas. ********* diff --git a/source/educators/references/course_development/exercise_tools/poll_olx.rst b/source/educators/references/course_development/exercise_tools/poll_olx.rst index 98717f91..055cdcbf 100644 --- a/source/educators/references/course_development/exercise_tools/poll_olx.rst +++ b/source/educators/references/course_development/exercise_tools/poll_olx.rst @@ -1,6 +1,5 @@ .. _Poll Tool for OLX: -################## Poll Tool for OLX ################## @@ -46,101 +45,6 @@ For example, when you want to find a specific section in your course, you look in the **Chapter** folder when you open the list of files that your course contains. To find a unit, you look in the **Vertical** folder. -.. _Create a Poll: - -************** -Create a Poll -************** - -#. In the unit where you want to create the poll, create components that - contain all the content that you want *except* for the poll. Make a note of - the 32-digit unit ID that appears in the **Unit Identifier** field under - **Unit Location**. - -#. Export your course. For information about how to do this, see - :ref:`Export a Course`. Save the .tar.gz file that contains - your course in a memorable location so that you can find it easily. - -#. Locate the .tar.gz file that contains your course, and then unpack the - .tar.gz file so that you can see its contents in a list of folders and - files. - - - To do this on a Windows computer, you need to download a third-party - program. For more information, see `How to Unpack a tar File in Windows - `_, - `How to Extract a Gz File `_, - `The gzip Home Page `_, or the `Windows - `_ - section of the `How to Open .tar.gz Files - `_ page. - - - For information about how to do this on a Mac, see the `Mac OS X `_ section of the `How to Open .tar.gz Files `_ page. - -#. In the list of folders and files, open the **Vertical** folder. - - .. note:: If your unit is not published, open the **Drafts** folder, and then open the **Vertical** folder in the **Drafts** folder. - -#. In the **Vertical** folder, locate the .xml file that has the same name as - the unit ID that you noted in step 1, and then open the file in a text - editor such as Sublime 2. For example, if the unit ID is - e461de7fe2b84ebeabe1a97683360d31, you open the - e461de7fe2b84ebeabe1a97683360d31.xml file. - - The file contains a list of all the components in the unit, together with - the URL names of the components. For example, the following file contains an - Text component followed by a discussion component. - - .. code-block:: xml - - - - - - -#. Add the following poll code in the location where you want the poll. Change - the text of the prompt to the text that you want. - - .. code-block:: xml - - -

Text of the prompt

- Yes - No - - - In the example above, if you wanted your poll to appear between the HTML - component and the discussion component in the unit, your code would resemble - the following. - - .. code-block:: xml - - - - -

Text of the prompt

- Yes - No - - - - -#. After you add the poll code, save and close the .xml file. - -#. Re-package your course as a .tar.gz file. - -#. In Studio, re-import your course. You can now review the poll question and - answers that you added in Studio. - -.. note:: - - * Although polls render correctly in Studio, you cannot edit them in Studio. - You will need to follow the export/import process outlined above to make - any edits to your polls. - - * A .csv file that contains student responses to the problem is not currently - available for polls. However, you can obtain the aggregate data directly in - the problem. - ********************* Format description ********************* @@ -210,7 +114,9 @@ Example of poll with unable reset functionality .. seealso:: :class: dropdown - + + :ref:`Create a Poll` (how to) + :ref:`Poll Tool` (reference) :ref:`Add Poll` (how to) diff --git a/source/educators/references/course_development/exercise_tools/view_qualtrics_responses.rst b/source/educators/references/course_development/exercise_tools/view_qualtrics_responses.rst index a27909eb..bd04d184 100644 --- a/source/educators/references/course_development/exercise_tools/view_qualtrics_responses.rst +++ b/source/educators/references/course_development/exercise_tools/view_qualtrics_responses.rst @@ -1,67 +1,27 @@ .. _View Qualtrics Responses: -******************************* View Survey Responses -******************************* +###################### .. tags:: educator, reference You can view both overall survey responses and responses for individual learners. -======================= + View Overall Responses -======================= +*********************** To view your overall survey results and analyze data, open your survey on the `Qualtrics website `_. -========================================================= + View Survey Responses for an Individual Learner ========================================================= To view a specific learner's survey responses, you must download data both from the Insructor Dashboard and from Qualtrics, and then review the data. -Download Data from the Instructor Dashboard -********************************************** - -#. In the LMS, select **Instructor**. -#. Select **Data Download**. -#. Under **Data Download**, select **Get Student Anonymized IDs CSV**. If you - receive a prompt, specify the location where you want to save the file. - - The .csv file is saved to your computer. The file has the following name. - - ``____anon-ids.csv`` - - For more information about anonymized student IDs, see - :ref:`Access_anonymized`. - -#. Under **Reports**, select **Download profile information as a CSV**. -#. When the profile information report appears in the list under **Reports - Available for Download**, select the report to download the .csv file to - your computer. The file has the following name. - - ``____student_profile_info_.csv`` - -For more information about accessing learner data, see :ref:`Learner Data`. - -Download Data from Qualtrics -******************************* - -.. note:: Because Qualtrics is a third-party tool, the following steps might - change without notice. See the `Qualtrics website - `_ for the most up-to-date Qualtrics documentation. - -#. In Qualtrics, select the **View Results** tab. -#. On the page that opens, select **Download Data** in the upper left corner - of the page. -#. On the page that opens, clear the **Compress the desired format into a .zip - file before downloading** check box. Accept all the other default values. -#. Under **Format**, select the **This is a Comma - Separated Values format...** link to download the .csv file. - Review the Data ****************** @@ -88,4 +48,8 @@ use functions such as VLOOKUP in Microsoft Excel. .. seealso:: :class: dropdown + :ref:`Poll Tool for OLX` (reference) + :ref:`Qualtrics Survey` (how to) + + :ref:`Download Data from the Instructor Dashboard` (how to) diff --git a/source/educators/references/dashboard_profile.rst b/source/educators/references/dashboard_profile.rst index a556719b..b1bbdd08 100644 --- a/source/educators/references/dashboard_profile.rst +++ b/source/educators/references/dashboard_profile.rst @@ -2,7 +2,7 @@ .. and Running Guide. SFD_dashboard_profile_SectionHead and .. CA_dashboard_profile_SectionHead files. -########################################### + The Dashboard, Profile, and Account Pages ########################################### @@ -26,7 +26,9 @@ menu options. settings and preferences. For example, you can update your password or email address and set your Time Zones. - .. only:: Partners +.. seealso:: + :class:dropdown + + :ref:`Course Outline` (concept) - On the **Account Settings** page, you can also view your `View Order History`_ and link your edX account to a social media or - organization account. \ No newline at end of file + :ref:`What is Studio` (concept)