Commit c9357985 by Mark Hoeber

Merge pull request #5318 from edx/markhoeber-doc936

Content experiments update
parents ef525f28 7889585c
...@@ -61,11 +61,12 @@ A group configuration defines how many groups of students are in an experiment. ...@@ -61,11 +61,12 @@ A group configuration defines how many groups of students are in an experiment.
You can have any number of group configurations in your course. When you create You can have any number of group configurations in your course. When you create
a content experiment, you select the group configuration to use. a content experiment, you select the group configuration to use.
For example, you may want to do two different experiments at different times during For example, you may want to do two different experiments at different times
your course. In one content experiment, students either see a video or complete a during your course. In one content experiment, students either see a video or
video or a reading assignment. You can then include problems so that you can see complete a reading assignment. You can then include problems so that you can
which group learned the material more completely. For this content experiment, you see which group learned the material more completely. For this content
need a group configuration that assigns your students to two groups. experiment, you need a group configuration that assigns your students to two
groups.
In the other content experiment, you can present the same question using four In the other content experiment, you can present the same question using four
different types of problem. For this content experiment, you need a different types of problem. For this content experiment, you need a
...@@ -106,7 +107,9 @@ Group assignments are: ...@@ -106,7 +107,9 @@ Group assignments are:
Set up Group Configurations in edX Studio Set up Group Configurations in edX Studio
************************************************ ************************************************
..note:: You must :ref:`enable content experiments<Enable Content Experiments>` before you can set up group configurations. ..note::
You must :ref:`enable content experiments<Enable Content Experiments>` before
you can set up group configurations.
To set up group configurations, on the **Settings** menu, select **Group To set up group configurations, on the **Settings** menu, select **Group
Configurations**. The **Group Configurations** page opens: Configurations**. The **Group Configurations** page opens:
...@@ -128,8 +131,8 @@ Create a Group Configuration ...@@ -128,8 +131,8 @@ Create a Group Configuration
You can create a group configuration at any time. You can create a group configuration at any time.
#. On the **Group Configurations** page, click **Add Your First Group Configuration**. The #. On the **Group Configurations** page, click **Add Your First Group
following page opens: Configuration**. The following page opens:
.. image:: ../Images/create-group-config.png .. image:: ../Images/create-group-config.png
:width: 800 :width: 800
...@@ -152,7 +155,9 @@ You can create a group configuration at any time. ...@@ -152,7 +155,9 @@ You can create a group configuration at any time.
5. Click **Create** to save the new group configuration. 5. Click **Create** to save the new group configuration.
The group configuration is then listed in the page. You can see the number of groups that the configuration contains, as well as whether the configuration is in use in the course: The group configuration is then listed in the page. You can see the number of
groups that the configuration contains, as well as whether the configuration is
in use in the course:
.. image:: ../Images/group_configurations_one_listed.png .. image:: ../Images/group_configurations_one_listed.png
:width: 800 :width: 800
...@@ -165,10 +170,10 @@ Edit a Group Configuration ...@@ -165,10 +170,10 @@ Edit a Group Configuration
============================= =============================
.. important:: .. important::
You can change the name of a group configuration at any time. However, You can change the name of a group configuration at any time. However, before
before you modify any other characteristics of a group that is inside a group configuration you modify any other characteristics of a group that is inside a group
that is currently used in a running course, review `Guidelines for Modifying Group configuration that is currently used in a running course, review `Guidelines
Configurations`_. for Modifying Group Configurations`_.
#. On the **Group Configurations** page, hover over the group configuration and #. On the **Group Configurations** page, hover over the group configuration and
click **Edit**. click **Edit**.
...@@ -195,8 +200,9 @@ Delete a Group Configuration ...@@ -195,8 +200,9 @@ Delete a Group Configuration
============================= =============================
.. note:: .. note::
You can only delete a group configuration that is not currently used in a content You can only delete a group configuration that is not currently used in a
experiment. You cannot delete a group configuration that is used in a content experiment. content experiment. You cannot delete a group configuration that is used in a
content experiment.
#. On the **Group Configurations** page, hover over the group configuration and #. On the **Group Configurations** page, hover over the group configuration and
click the Delete icon. click the Delete icon.
...@@ -215,8 +221,9 @@ View Experiments that Use a Group Configuration ...@@ -215,8 +221,9 @@ View Experiments that Use a Group Configuration
When working with group configurations, you can view the experiments that use When working with group configurations, you can view the experiments that use
each configuration. each configuration.
On the **Group Configurations** page, click the name of a group to expand the group On the **Group Configurations** page, click the name of a group to expand the
and see its details. You see links to experiments that use the group configuration: group and see its details. You see links to experiments that use the group
configuration:
.. image:: ../Images/group_configurations_experiments.png .. image:: ../Images/group_configurations_experiments.png
:alt: A group configuration with the experiments using it circled :alt: A group configuration with the experiments using it circled
...@@ -230,8 +237,8 @@ View a Group Configuration from an Experiment ...@@ -230,8 +237,8 @@ View a Group Configuration from an Experiment
When working with a content experiment, you can view details about the group When working with a content experiment, you can view details about the group
configuration used by that experiment. configuration used by that experiment.
On the unit page for a unit that contains a content experiment, click the name of the group On the unit page for a unit that contains a content experiment, click the name
configuration. of the group configuration.
.. image:: ../Images/content_experiment_group_config_link.png .. image:: ../Images/content_experiment_group_config_link.png
:alt: Content experiment in the unit page with the group configuration link :alt: Content experiment in the unit page with the group configuration link
......
...@@ -11,6 +11,11 @@ Also known as A/B or split tests, content experiments enable you to ...@@ -11,6 +11,11 @@ Also known as A/B or split tests, content experiments enable you to
research and compare the performance of students in different groups to gain research and compare the performance of students in different groups to gain
insight into the relative effectiveness of your course content. insight into the relative effectiveness of your course content.
Information on analyzing events from content experiments is included in the
`edX Researcher Guide`_.
.. _edX Researcher Guide: http://edx.readthedocs.org/projects/devdata/en/latest/internal_data_formats/tracking_logs.html#a-b-testing-events
.. caution:: .. caution::
If you have graded problems within a content experiment, grade exports do not If you have graded problems within a content experiment, grade exports do not
work for your course. This issue is currently being addressed. work for your course. This issue is currently being addressed.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment