New chapter for instant hangouts

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

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:
 

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:
 
 *****************************************

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:

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. 
    

docs/en_us/course_authors/source/discussion_guidance_moderators.rst

+.. _Guidance for Discussion Moderators:
+
 ######################################
 Guidance for Discussion Moderators
 ######################################

docs/en_us/course_authors/source/discussions.rst

+.. _Discussions:
+
 ############################
 Discussions
 ############################

docs/en_us/course_authors/source/google_hangouts.rst

+.. _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 <http://www.google.com/+/learnmore/hangouts/>`_.
+
+.. 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.
+
+* 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.
+
+An instant hangout is specific to the page it is opened from.  So, for example, students who join a hangout from one course unit interact among themselves, while students who join a hangout from another unit interact together in a different hangout.
+
+.. _The Student Experience:
+
+*************************
+The Student Experience
+*************************
+
+When you add the Instant Hangout to you course, students see the control to join the hangout. The following example shows the control in a static page when. The control shows that there is one other student 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**.
+
+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**.
+
+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 log in page.
+
+Once 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 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 <https://raw.github.com/google/instant-hangouts/master/instanthangouts-0.1.0.js>`_.
+
+#. Copy the text of this file into a local JavaScript file.
+
+   ..note:  Ensure you copy the raw GitHub file, not the formatted file. Any formatting will cause the JavaScript to not work correctly.
+
+#. Upload the JavaScript file to 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.
+
+#. Add the JavaScript file you uploaded in a <script> tag, for example::
+  
+    <script src='/static/instanthangouts-0.1.0.js'/>
+
+5. After the <script> tag, add::
+  
+    <div class='instanthangouts'/>
+
+  For example, the complete HTML could be::
+
+    <p>Join the Instant Hangout by clicking the icon below. 
+    You can use the hangout to have live video discussions with other students.</p>
+    <script src='/static/instanthangouts-0.1.0.js'></script>
+    <div class='instanthangouts'/>
+
+6. Test the instant hangout in your course.
+
+=============================
+Updating the JavaScript File
+=============================
+
+Google will periodically update the instant hangouts JavaScript file.  You should watch the `instant hangouts repository <https://github.com/google/instant-hangouts/>`_ to get notified of any updates.
+
+To use an updated JavaScript file in your course, it is recommended that you copy the JavaScript from the repository into a file of the same name you uploaded to your course.  Then upload that file to replace the previous file.
+
+If you include version numbers in the file names of uplaoded files, you will have to edit any HTML components or static pages that include an instant hangout control with every update.

docs/en_us/course_authors/source/index.rst

@@ -25,6 +25,7 @@ Contents
    advanced_problems
    specialized_problems
    open_response_assessment
+   google_hangouts
    tools
    set_content_releasedates
    view_course_content