diff --git a/docs/en_us/course_authors/source/Images/google_login.png b/docs/en_us/course_authors/source/Images/google_login.png new file mode 100644 index 0000000000..e6f599040e Binary files /dev/null and b/docs/en_us/course_authors/source/Images/google_login.png differ diff --git a/docs/en_us/course_authors/source/Images/hangout.png b/docs/en_us/course_authors/source/Images/hangout.png new file mode 100644 index 0000000000..64aa2728c1 Binary files /dev/null and b/docs/en_us/course_authors/source/Images/hangout.png differ diff --git a/docs/en_us/course_authors/source/Images/hangout_static_page.png b/docs/en_us/course_authors/source/Images/hangout_static_page.png new file mode 100644 index 0000000000..ecfb77f8c6 Binary files /dev/null and b/docs/en_us/course_authors/source/Images/hangout_static_page.png differ diff --git a/docs/en_us/course_authors/source/Images/hangout_unit.png b/docs/en_us/course_authors/source/Images/hangout_unit.png new file mode 100644 index 0000000000..8fbf395548 Binary files /dev/null and b/docs/en_us/course_authors/source/Images/hangout_unit.png differ diff --git a/docs/en_us/course_authors/source/Images/static_page_hangout.png b/docs/en_us/course_authors/source/Images/static_page_hangout.png new file mode 100644 index 0000000000..90cfb92e37 Binary files /dev/null and b/docs/en_us/course_authors/source/Images/static_page_hangout.png differ diff --git a/docs/en_us/course_authors/source/change_log.rst b/docs/en_us/course_authors/source/change_log.rst index bebcdaf312..12e6383a44 100644 --- a/docs/en_us/course_authors/source/change_log.rst +++ b/docs/en_us/course_authors/source/change_log.rst @@ -13,6 +13,8 @@ Change Log * - Date - Change + * - 01/29/2014 + - Added the chapter :ref:`Using an Instant Hangout in Your Course`. * - 01/21/2014 - Added more detailed instructions to :ref:`Zooming image` * - 01/14/2014 diff --git a/docs/en_us/course_authors/source/create_discussion.rst b/docs/en_us/course_authors/source/create_discussion.rst index 0d7ae09ad8..b619f9fbe8 100644 --- a/docs/en_us/course_authors/source/create_discussion.rst +++ b/docs/en_us/course_authors/source/create_discussion.rst @@ -16,8 +16,12 @@ See the following topics: * :ref:`A Student's View of the Discussion` -Before you add a Discussion component, it is generally a good idea to add an HTML component that -introduces the topic to be discussed. The Discussion component itself does not contain any text and may be easy for students to overlook. +Before you add a Discussion component, it is generally a good idea to add an HTML component that introduces the topic to be discussed. The Discussion component itself does not contain any text and may be easy for students to overlook. + +Also see the following chapters: + +* :ref:`Discussions` +* :ref:`Guidance for Discussion Moderators`ß .. _Create a Discussion Component: diff --git a/docs/en_us/course_authors/source/create_html_component.rst b/docs/en_us/course_authors/source/create_html_component.rst index 809c39fbc9..76ffdfde0b 100644 --- a/docs/en_us/course_authors/source/create_html_component.rst +++ b/docs/en_us/course_authors/source/create_html_component.rst @@ -21,6 +21,8 @@ For more information, see the following topics: .. note:: Review :ref:`Organizing Your Course Content` and :ref:`Best Practices for HTML Markup` before you start working with HTML components. +To add an instant hangout to an HTML component, see :ref:`Using an Instant Hangout in Your Course`. + .. _The User Interface: ***************************************** diff --git a/docs/en_us/course_authors/source/create_new_course.rst b/docs/en_us/course_authors/source/create_new_course.rst index 451075780c..5a8fb5a50e 100644 --- a/docs/en_us/course_authors/source/create_new_course.rst +++ b/docs/en_us/course_authors/source/create_new_course.rst @@ -319,6 +319,8 @@ For example, the following navigation bar includes a You can use static pages for a syllabus, grading policy, course handouts, or any other purpose. +You can also add an instant hangout to a static page. See :ref:`Using an Instant Hangout in Your Course` for more information. + .. note:: The Course Info, Discussion, Wiki, and Progress pages are displayed to students by default. You cannot delete these pages. To create a static page: diff --git a/docs/en_us/course_authors/source/create_video.rst b/docs/en_us/course_authors/source/create_video.rst index 446ac6ca2d..18ad8bace2 100644 --- a/docs/en_us/course_authors/source/create_video.rst +++ b/docs/en_us/course_authors/source/create_video.rst @@ -137,6 +137,7 @@ Step 4. Create a Video Component #. When the new video component appears, click **Edit**. The video editor opens to the **Basic** tab. .. image:: Images/VideoComponentEditor.gif + :alt: Image of the video component editor You'll replace the default values with your own. diff --git a/docs/en_us/course_authors/source/discussion_guidance_moderators.rst b/docs/en_us/course_authors/source/discussion_guidance_moderators.rst index 1136e96b41..5b292cac4e 100644 --- a/docs/en_us/course_authors/source/discussion_guidance_moderators.rst +++ b/docs/en_us/course_authors/source/discussion_guidance_moderators.rst @@ -1,3 +1,5 @@ +.. _Guidance for Discussion Moderators: + ###################################### Guidance for Discussion Moderators ###################################### diff --git a/docs/en_us/course_authors/source/discussions.rst b/docs/en_us/course_authors/source/discussions.rst index 8ada23e927..146733ecda 100644 --- a/docs/en_us/course_authors/source/discussions.rst +++ b/docs/en_us/course_authors/source/discussions.rst @@ -1,3 +1,5 @@ +.. _Discussions: + ############################ Discussions ############################ diff --git a/docs/en_us/course_authors/source/google_hangouts.rst b/docs/en_us/course_authors/source/google_hangouts.rst new file mode 100644 index 0000000000..996981360e --- /dev/null +++ b/docs/en_us/course_authors/source/google_hangouts.rst @@ -0,0 +1,134 @@ +.. _Using an Instant Hangout in Your Course: + +########################################### +Using an Instant Hangout in Your Course +########################################### + +This chapter describes how you can use instant hangouts in your course. See: + +* :ref:`Hangouts_Overview` +* :ref:`Instant Hangouts in Your Course` +* :ref:`The Student Experience` +* :ref:`Limitations` +* :ref:`Create the Instant Hangout` + +.. _Hangouts_Overview: + +***************** +Overview +***************** + +You can add the ability for students to participate in instant hangouts directly from your course. + +With instant hangouts, students can: + +* Interact through live video and voice. +* Share screens and watch videos together. +* Collaborate on documents. + +For a full list of instant hangout features, see the `Google Hangouts page `_. + +.. note:: Students who want to participate in instant hangouts must have a Google account. You should note this in your course materials. + +.. _Instant Hangouts in Your Course: + +********************************** +Instant Hangouts in Your Course +********************************** + +You can add one or more instant hangouts in your course. For example, you can add an instant hangout: + +* In a static page, to provide students with a hangout for the entire course. See :ref:`Add Static Pages` for more information about static pages. + +* In an HTML component, to provide a hangout for students working on that specific course unit. See :ref:`Working with HTML Components` for more information about creating HTML components. + +An instant hangout is specific to the page it is opened from. For example, students who join a hangout from one course unit interact among themselves, while students who join a hangout from another unit interact in a different hangout. + +.. _The Student Experience: + +************************* +The Student Experience +************************* + +When you add the instant hangout to your course, a control for the hangout appears on that page. The following example shows the control in a course unit. The control shows that the student can start the hangout and be the first participant. + +.. image:: Images/hangout_unit.png + :alt: Image of the instant hangout control on a unit + +To start the hangout, the student clicks **Start the Hangout**. (After the first student clicks **Start the Hangout**, other students see a **Join the Hangout** button.) + +The following example shows the control in a static page when a hangout has already started. The control has a **Join the Hangout** button, and shows that one other student is already in the hangout. + +.. image:: Images/hangout_static_page.png + :alt: Image of the instant hangout control on a static page + +To join the hangout, the student clicks **Join the Hangout**. + +If not already logged in, the student is prompted to log in to Google: + +.. image:: Images/google_login.png + :alt: Image of the Google login page + +Students who do not have a Google account can create one from the login page. + +After the student has logged in to Google, the hangout opens in a separate browser window: + +.. image:: Images/hangout.png + :alt: Image of the instant hangout + +.. _Limitations: + +**************** +Limitations +**************** + +Currently, only ten students can join a single instant hangout. You should note this in your course materials. + +Students in hangouts that are started from different pages in your course are counted separately. So you can have ten students participating in a hangout started from one unit, and ten other students in a hangout started from a different unit. + +.. _Create the Instant Hangout: + +************************************************** +Create the Instant Hangout +************************************************** + +To create an instant hangout in your course: + +#. Get the `instant hangout JavaScript file from GitHub `_. + +#. Copy the text of this file into a text editor on your computer, and save the file as a JavaScript file (that is, when you save the file, change the extension from .txt to .js). + + .. note:: Make sure that you copy the raw GitHub file, which does not contain formatting. Do not copy the formatted file. Any formatting will cause the JavaScript to not work correctly. + +#. Upload the JavaScript file to the **Files & Uploads** page in your course. See :ref:`Add Files to a Course` for more information. + +#. In either a static page or an HTML component, open the HTML editor. + +#. On the first line, add the JavaScript file you uploaded in a +
+ +#. Test the instant hangout in your course. + +============================= +Updating the JavaScript File +============================= + +Google will periodically update the instant hangouts JavaScript file. To receive update notifications, go to the `instant hangouts repository page `_, and then click **Watch** in the upper-right area of the page. + +To use an updated JavaScript file in your course, we recommend that you copy the JavaScript from the repository into a file that has the same name as the file that you uploaded to your course. When you upload the new file, the new file replaces the previous file. + +.. warning:: If you include version numbers in the file names of uploaded files, you will have to edit any HTML components or static pages that include an instant hangout control every time that you update the JavaScript file. diff --git a/docs/en_us/course_authors/source/index.rst b/docs/en_us/course_authors/source/index.rst index 1d312101e9..9c85f582c2 100755 --- a/docs/en_us/course_authors/source/index.rst +++ b/docs/en_us/course_authors/source/index.rst @@ -26,6 +26,7 @@ Contents specialized_problems external_graders open_response_assessment + google_hangouts tools set_content_releasedates view_course_content