diff --git a/docs/_static/in_context_course.png b/docs/_static/in_context_course.png deleted file mode 100644 index d06e826..0000000 Binary files a/docs/_static/in_context_course.png and /dev/null differ diff --git a/docs/_static/in_context_final_results.png b/docs/_static/in_context_final_results.png new file mode 100644 index 0000000..ad329a5 Binary files /dev/null and b/docs/_static/in_context_final_results.png differ diff --git a/docs/_static/in_context_initial_responses.png b/docs/_static/in_context_initial_responses.png new file mode 100644 index 0000000..40f9f13 Binary files /dev/null and b/docs/_static/in_context_initial_responses.png differ diff --git a/docs/_static/in_context_problem_engagement.png b/docs/_static/in_context_problem_engagement.png new file mode 100644 index 0000000..71f98ae Binary files /dev/null and b/docs/_static/in_context_problem_engagement.png differ diff --git a/docs/_static/in_context_problem_results.png b/docs/_static/in_context_problem_results.png new file mode 100644 index 0000000..e67e809 Binary files /dev/null and b/docs/_static/in_context_problem_results.png differ diff --git a/docs/_static/in_context_sidebar.png b/docs/_static/in_context_sidebar.png index a14882c..7fd517c 100644 Binary files a/docs/_static/in_context_sidebar.png and b/docs/_static/in_context_sidebar.png differ diff --git a/docs/_static/in_context_subsection_engagement.png b/docs/_static/in_context_subsection_engagement.png new file mode 100644 index 0000000..78efa82 Binary files /dev/null and b/docs/_static/in_context_subsection_engagement.png differ diff --git a/docs/_static/in_context_subsection_performance.png b/docs/_static/in_context_subsection_performance.png new file mode 100644 index 0000000..e3616c8 Binary files /dev/null and b/docs/_static/in_context_subsection_performance.png differ diff --git a/docs/_static/in_context_video.png b/docs/_static/in_context_video.png index 01e26ec..477049d 100644 Binary files a/docs/_static/in_context_video.png and b/docs/_static/in_context_video.png differ diff --git a/docs/_static/in_context_video_engagement.png b/docs/_static/in_context_video_engagement.png new file mode 100644 index 0000000..8f2e4ec Binary files /dev/null and b/docs/_static/in_context_video_engagement.png differ diff --git a/docs/reference/in_context_dashboards.rst b/docs/reference/in_context_dashboards.rst index a6f33c4..33e5fbf 100644 --- a/docs/reference/in_context_dashboards.rst +++ b/docs/reference/in_context_dashboards.rst @@ -12,52 +12,60 @@ Course Dashboard This board contains 3 charts presenting course-level metrics, and is displayed when viewing in-context analytics for the course outline. -.. image:: /_static/in_context_course.png - Subsection Engagement: ====================== The first chart shows the number of learners who attempted at least one problem in each graded subsection throughout the course and the average subsection score for those learners. +.. image:: /_static/in_context_subsection_engagement.png + Problem Engagement: =================== The second chart shows the number of learners who attempted each problem in the course and the percentage of learners who got each problem correct on their first attempt at the problem. A high percentage correct on the first attempt indicates that learners are finding the problem manageable (even easy if the percentage is very high), while a low percentage correct on the first attempt indicates that the problem may be very difficult or potentially unclear to learners. +.. image:: /_static/in_context_problem_engagement.png + Video Engagement: ================= The third chart shows the number of unique and repeat views for each video in the course. +.. image:: /_static/in_context_video_engagement.png + Graded Subsection Performance ***************************** This board contains 2 charts presenting subsection-level metrics, and is displayed when viewing in-context analytics for a graded subsection from the course outline. -.. image:: /_static/in_context_graded_subsection.png - Graded Subsection Performance: ============================== The first chart shows the number of respondents in each score range for the graded subsection as well as the average subsection score for all learners who attempted at least one problem in the subsection. +.. image:: /_static/in_context_subsection_performance.png + Final Response Results: ======================= The second chart shows the total number of correct and incorrect responses for each problem in the subsection. +.. image:: /_static/in_context_final_results.png + Problem ******* This board contains 2 tables presenting problem-level metrics, and is displayed when viewing in-context analytics for a problem block from the course outline or from a unit page. -.. image:: /_static/in_context_problem.png - Problem Results Table: ====================== The first table shows the percentage of correct attempts and of correct first attempts. +.. image:: /_static/in_context_problem_results.png + Initial Responses: ================== The second table shows a breakdown of how learners responded to the problem on their first attempt. The idea is to give course delivery teams a peak into learners’ thought process when they approach the problem for the first time. +.. image:: /_static/in_context_initial_responses.png + Video ***** diff --git a/docs/technical_documentation/how-tos/aspects_production_configuration.rst b/docs/technical_documentation/how-tos/aspects_production_configuration.rst index c9e72bb..f6b6658 100644 --- a/docs/technical_documentation/how-tos/aspects_production_configuration.rst +++ b/docs/technical_documentation/how-tos/aspects_production_configuration.rst @@ -202,7 +202,7 @@ By default, Aspects enables plugin functionality in the LMS that embeds a define In-Context Metrics ------------------ -Starting in the Teak Open edX release, Aspects provides :ref:`In-Context Dashboards` in Studio. Reference the `plugin ` for setup instructions. +Starting in the Teak Open edX release, Aspects provides :ref:`In-Context Dashboards` in Studio. Reference the `plugin `_ for setup instructions. For further customization, the setting ``ASPECTS_IN_CONTEXT_DASHBOARDS`` (in `platform-plugin-aspects`_) is a dictionary mapping block types to in-context dashboards. You can use this setting to remove or replace the in-context dashboard for a block type. The key `course` defines the in-context dashboard for course overview.