From acae71f113fcc3af5e2b52817b34f7fc94b734cb Mon Sep 17 00:00:00 2001 From: Sara Burns Date: Thu, 12 Mar 2026 09:31:39 -0400 Subject: [PATCH 1/3] docs: add upgrade instructions for 2.5 --- docs/technical_documentation/how-tos/02_upgrade.rst | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/technical_documentation/how-tos/02_upgrade.rst b/docs/technical_documentation/how-tos/02_upgrade.rst index fea16a8..beaf428 100644 --- a/docs/technical_documentation/how-tos/02_upgrade.rst +++ b/docs/technical_documentation/how-tos/02_upgrade.rst @@ -59,7 +59,7 @@ v3.x Ulmo and later =============== ====================================== -Upgrading v2.x to v3.x +Upgrading v2.5 to v3.x ---------------------- Breaking Changes @@ -68,6 +68,16 @@ Breaking Changes In-Context Analytics in Aspects v3.0 uses Paragon v23 which was introduced in Open edX Ulmo. Therefore, Aspects v3.x requires Open edX Ulmo or later. If you are running a named release before Ulmo, you will need to upgrade to Ulmo or later before upgrading Aspects to v3.x. +Upgrading to v2.5 +----------------- + +There were multiple changes to dbt views which will need to be manually refreshed. Do this by running: + +.. code-block:: bash + + tutor [local/dev/k8s] do dbt --only_changed False -c 'run --full-refresh --select dim_problem_responses+ fact_video_segments+ dim_course_blocks+ fact_navigation_completion+ fact_pageview_engagement+ problem_events+ dim_learner_last_response+ dim_problem_results+ dim_subsection_problem_results+ fact_problem_engagement+ dim_problem_coursewide_avg+ dim_subsection_performance+' + + Upgrading v1.x to v2.x ---------------------- From 63b6cdae82172c594b182f0a437d15e0552dab47 Mon Sep 17 00:00:00 2001 From: Sara Burns Date: Thu, 12 Mar 2026 09:32:38 -0400 Subject: [PATCH 2/3] docs: add link to release notes --- docs/technical_documentation/how-tos/02_upgrade.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/technical_documentation/how-tos/02_upgrade.rst b/docs/technical_documentation/how-tos/02_upgrade.rst index beaf428..b2b2d18 100644 --- a/docs/technical_documentation/how-tos/02_upgrade.rst +++ b/docs/technical_documentation/how-tos/02_upgrade.rst @@ -68,7 +68,7 @@ Breaking Changes In-Context Analytics in Aspects v3.0 uses Paragon v23 which was introduced in Open edX Ulmo. Therefore, Aspects v3.x requires Open edX Ulmo or later. If you are running a named release before Ulmo, you will need to upgrade to Ulmo or later before upgrading Aspects to v3.x. -Upgrading to v2.5 +Upgrading to `v2.5 `_ ----------------- There were multiple changes to dbt views which will need to be manually refreshed. Do this by running: From 3815bd477e3e97ef27cdb651fb04271c3a8c85c5 Mon Sep 17 00:00:00 2001 From: Sara Burns Date: Thu, 12 Mar 2026 09:34:46 -0400 Subject: [PATCH 3/3] docs: fix underline Clarified upgrade requirements for Aspects v3.x and added instructions for refreshing dbt views. --- docs/technical_documentation/how-tos/02_upgrade.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/technical_documentation/how-tos/02_upgrade.rst b/docs/technical_documentation/how-tos/02_upgrade.rst index b2b2d18..57b511c 100644 --- a/docs/technical_documentation/how-tos/02_upgrade.rst +++ b/docs/technical_documentation/how-tos/02_upgrade.rst @@ -69,7 +69,7 @@ In-Context Analytics in Aspects v3.0 uses Paragon v23 which was introduced in Op Upgrading to `v2.5 `_ ------------------ +------------------------------------------------------------------------------------------- There were multiple changes to dbt views which will need to be manually refreshed. Do this by running: