Merge pull request #355 from arbrandes/add-howto-videos

docs: add how-to videos
openedx · Jul 24, 2023 · 0a52fac · 0a52fac
2 parents 0630cc3 + 9a192f5
commit 0a52fac
Show file tree

Hide file tree

Showing 27 changed files with 127 additions and 18 deletions.
diff --git a/source/educators/how-tos/add_checkbox.rst b/source/educators/how-tos/add_checkbox.rst
@@ -1,3 +1,6 @@
 Add a Checkbox Problem
-#############################
+######################
 
+To create a checkbox (also known as "multi-select") problem, follow this video guide:
+
+.. youtube:: 6VYKcMeZrxg
diff --git a/source/educators/how-tos/add_content_iframe.rst b/source/educators/how-tos/add_content_iframe.rst
@@ -0,0 +1,7 @@
+Add Content in an Iframe
+########################
+
+If you have externally hosted content, you can add it to a course via an iframe:
+
+.. youtube:: Fw5zb1WBD_o
+
diff --git a/source/educators/how-tos/add_course_creators.rst b/source/educators/how-tos/add_course_creators.rst
@@ -1,5 +1,5 @@
 Add Course Creators
-####################
+###################
 
 
 When you create a new course in Studio, you are automatically an Admin in the course, meaning you can create and add course creators, in addition to being able to create and manage course content.
@@ -25,4 +25,6 @@ The user is now listed as staff and can use Studio to modify the course.
 
 You can also make the user an Admin. For information on different roles, see :doc:`../references/user_roles`.
 
+For a step-by-step to grant staff permissions to courses, check out this video:
 
+.. youtube:: IwuGccK49m8
diff --git a/source/educators/how-tos/add_course_page.rst b/source/educators/how-tos/add_course_page.rst
@@ -1,3 +1,6 @@
 Add a Course Page
-###########################################
+#################
 
+You can create a custom course page as demonstrated in the following video:
+
+.. youtube:: vIR9auBmiFU
diff --git a/source/educators/how-tos/add_course_updates.rst b/source/educators/how-tos/add_course_updates.rst
@@ -0,0 +1,6 @@
+Add Course Updates and Hand-outs
+################################
+
+Watch this video to understand how to add course updates and hand-outs:
+
+.. youtube:: 3rPeuFR6UDI
diff --git a/source/educators/how-tos/add_dropdown.rst b/source/educators/how-tos/add_dropdown.rst
@@ -1,3 +1,6 @@
 Add a Dropdown Problem
-#############################
+######################
 
+This video explains how to add a dropdown-type problem:
+
+.. youtube:: e6HxKo18_xE
diff --git a/source/educators/how-tos/add_image.rst b/source/educators/how-tos/add_image.rst
@@ -1,3 +1,6 @@
 Add an Image
-#############################
+############
 
+This video will take you through adding images (and text!) to your course:
+
+.. youtube:: -CQekI4-Hjw
diff --git a/source/educators/how-tos/add_multiple_choice.rst b/source/educators/how-tos/add_multiple_choice.rst
@@ -1,3 +1,6 @@
 Add a Multiple Choice Problem
-##############################
+#############################
 
+This video explains how to add a multiple choice (also known as "single-select") problem:
+
+.. youtube:: ij5VHvY6jBk
diff --git a/source/educators/how-tos/add_numerical_input.rst b/source/educators/how-tos/add_numerical_input.rst
@@ -1,3 +1,6 @@
 Add a Numerical Input Problem
-##############################
+#############################
 
+This video will show you how to create a numerical input problem:
+
+.. youtube:: fkoF8ZDPMoQ
diff --git a/source/educators/how-tos/add_text_input.rst b/source/educators/how-tos/add_text_input.rst
@@ -1,3 +1,6 @@
 Add a Text Input Problem
-##############################
+########################
 
+Watch this video to understand how to create a text-input problem:
+
+.. youtube:: W8hIxVDebvo
diff --git a/source/educators/how-tos/add_transcript_other_language.rst b/source/educators/how-tos/add_transcript_other_language.rst
@@ -1,3 +1,6 @@
 Add a Transcript in Another Language
-#####################################
+####################################
 
+Watch this for an overview of how to add a transcript to a video, including different languages:
+
+.. youtube:: qABNazvnAE0
diff --git a/source/educators/how-tos/add_video_quiz.rst b/source/educators/how-tos/add_video_quiz.rst
@@ -0,0 +1,6 @@
+Add an In-Video Quiz
+####################
+
+It's possible to add quizzes directly to a video!  Watch this for a how-to:
+
+.. youtube:: 87WT3nGOHwc
diff --git a/source/educators/how-tos/add_written_content.rst b/source/educators/how-tos/add_written_content.rst
@@ -1,3 +1,6 @@
 Add Written Content
-#############################
+###################
 
+This video will take you through adding text (and images!) to your course:
+
+.. youtube:: -CQekI4-Hjw
diff --git a/source/educators/how-tos/course_reruns.rst b/source/educators/how-tos/course_reruns.rst
@@ -0,0 +1,6 @@
+Course re-runs
+##############
+
+It is possible to schedule a re-run of an existing course, as described in the following video:
+
+.. youtube:: jLa3DsHm_Vk
diff --git a/source/educators/how-tos/create_course.rst b/source/educators/how-tos/create_course.rst
@@ -1,5 +1,5 @@
 Create a Course
-#################
+###############
 
 .. include:: reusable_content/create_course.txt
 
diff --git a/source/educators/how-tos/create_course_about_page.rst b/source/educators/how-tos/create_course_about_page.rst
@@ -1,3 +1,6 @@
 Create the Course About Page
-#############################
+############################
 
+Watch this video to understand how to create a course description:
+
+.. youtube:: ruXRjT176Cs
diff --git a/source/educators/how-tos/create_video.rst b/source/educators/how-tos/create_video.rst
@@ -1,3 +1,6 @@
 Create a Video
-#############################
+##############
 
+This is how you can add a video to a course:
+
+.. youtube:: 9C8YTP75HpA
diff --git a/source/educators/how-tos/import_scorm_content.rst b/source/educators/how-tos/import_scorm_content.rst
@@ -0,0 +1,7 @@
+Importing SCORM Content
+#######################
+
+If you have the need to import SCORM content into your course, watch this video:
+
+.. youtube:: 32LgmaDhu6o
+
diff --git a/source/educators/how-tos/importing_exporting.rst b/source/educators/how-tos/importing_exporting.rst
@@ -0,0 +1,6 @@
+Importing and Exporting a Course
+################################
+
+It is possible to import, as well as export, an entire course.  See the following for details:
+
+.. youtube:: q8QJB5KVKbw
diff --git a/source/educators/how-tos/index.rst b/source/educators/how-tos/index.rst
@@ -19,6 +19,8 @@ Educators: How-tos
          create_course_about_page
          set_up_prerequisites
          set_up_certificates
+         importing_exporting
+         course_reruns
 
    .. grid-item-card::
       :class-card: sd-shadow-md sd-p-2
@@ -46,8 +48,13 @@ Educators: How-tos
 
          add_written_content
          add_image
+         add_content_iframe
          copy_paste_course_content
          manage_files
+         add_course_updates
+         import_scorm_content
+         using_lti
+         leveraging_libraries
 
    .. grid-item-card::
       :class-card: sd-shadow-md sd-p-2
@@ -91,6 +98,7 @@ Educators: How-tos
          write_grader
          math_expression
          open_response
+         add_video_quiz
 
    .. grid-item-card::
       :class-card: sd-shadow-md sd-p-2

diff --git a/source/educators/how-tos/leveraging_libraries.rst b/source/educators/how-tos/leveraging_libraries.rst
@@ -0,0 +1,6 @@
+Leveraging Libraries
+####################
+
+You can use libraries to organize content into a set of reusable, randomizable components.  See the following for details:
+
+.. youtube:: dfqAQ1vSHvc
diff --git a/source/educators/how-tos/manage_files.rst b/source/educators/how-tos/manage_files.rst
@@ -1,3 +1,6 @@
 Manage Course Files
-#############################
+###################
 
+Did you know you can add files to your course and make them available to learners?  This is how to add textbooks PDFs:
+
+.. youtube:: CaSbi09YpJU
diff --git a/source/educators/how-tos/set_up_certificates.rst b/source/educators/how-tos/set_up_certificates.rst
@@ -1,3 +1,6 @@
 Set Up Certificates
-#############################
+###################
 
+You can use the following video for help in setting up certificates:
+
+.. youtube:: 5Ys-E5K0_NY
diff --git a/source/educators/how-tos/set_up_content_groups.rst b/source/educators/how-tos/set_up_content_groups.rst
@@ -1,3 +1,6 @@
 Set Up Content Groups
-#############################
+#####################
 
+To set up cohorts and content groups, see this video:
+
+.. youtube:: rp7st8yxC5E
diff --git a/source/educators/how-tos/set_up_prerequisites.rst b/source/educators/how-tos/set_up_prerequisites.rst
@@ -1,3 +1,6 @@
 Set Up Course Prerequisites
-#############################
+###########################
 
+For help in setting up course requirements, watch this video:
+
+.. youtube:: f7jYFW-iHFw
diff --git a/source/educators/how-tos/using_lti.rst b/source/educators/how-tos/using_lti.rst
@@ -0,0 +1,6 @@
+Using LTI
+#########
+
+It is possible to use LTI content in a course, too!  See this video for details:
+
+.. youtube:: dJuEGsZM4gw
diff --git a/source/site_ops/quickstarts/index.rst b/source/site_ops/quickstarts/index.rst
@@ -1,2 +1,6 @@
 Site Operators: Quick Start
-#############################
+###########################
+
+Watch the following video on how to set up Open edX quickly using Tutor:
+
+.. youtube:: QngJaemFLms