diff --git a/docs/en_us/course_authors/source/Images/PollExample.png b/docs/en_us/course_authors/source/Images/PollExample.png new file mode 100644 index 0000000000..e21602952f Binary files /dev/null and b/docs/en_us/course_authors/source/Images/PollExample.png differ diff --git a/docs/en_us/course_authors/source/additional_tools.rst b/docs/en_us/course_authors/source/additional_tools.rst index c49ab82a4c..925607276c 100644 --- a/docs/en_us/course_authors/source/additional_tools.rst +++ b/docs/en_us/course_authors/source/additional_tools.rst @@ -18,6 +18,7 @@ Below, we provide you with all the files and code that you need to create the fo * :ref:`Interactive Periodic Table` * :ref:`Molecule Editor` * :ref:`Multiple Choice and Numerical Input` +* :ref:`Polls` * :ref:`Protein Builder` .. _Gene Explorer: @@ -387,6 +388,50 @@ Multiple Choice and Numerical Input Problem Code +.. _Polls: + +****** +Polls +****** + +You can run polls in your course to gauge students' responses to different questions. + +.. image:: /Images/PollExample.png + +Create a Unit all the Components you want other than the polls (see "Regular Section" for an example of a pre-poll section). +Export the tarball of your course ("Tools") +Find the problem you wish to edit in the "verticals" folder. Open it with a text editor (an editor such as Sublime 2 is geared towards programming). +Add poll questions in between the and tags. A template is below. + +.. code-block:: xml + +

This is where you put the prompt

+ Yes + No +
+ +As a result, your code should look something like the below: + +.. code-block:: xml + + + +

This is where you put the prompt

+ Yes + No +
+ +
+ +Re-tarball your course (how to do this in Terminal here) +Import the tarball +Notes + +Although the polls will render correctly in Studio, you will not be able to edit them in Studio. You will need to follow the export/import process outlined above to make any edits to your polls. +You will be editing the raw XML code of your course to add this feature. We do not recommend attempting to edit other areas of your course in this method unless you have the necessary background and training. +A CSV for student responses to the problem is not currently available for polls, though the aggregate data is easily obtained directly in the problem. + + .. _Protein Builder: ************************