Skip to content

docs: sync Verawood dev/operator release notes with wiki updates - #1486

Merged
sarina merged 6 commits into
openedx:verawood/operator-rnsfrom
feoh:cpatti/verawood-release-notes
Jul 28, 2026
Merged

docs: sync Verawood dev/operator release notes with wiki updates#1486
sarina merged 6 commits into
openedx:verawood/operator-rnsfrom
feoh:cpatti/verawood-release-notes

Conversation

@feoh

@feoh feoh commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Description

Syncs the Verawood developer & operator release notes with the latest content on the Verawood - Operator Release Notes wiki page, which has been updated since these notes were first drafted.

Changes:

  • Corrected the Upgrade/upsell widget entry (enabled by default, updated config keys/slot names).
  • Added the new "notifications enabled by default" opt-out waffle flag change.
  • Documented removal of course-level notification preferences, the is_core preference flag, and the V2 notification preferences config API.
  • Expanded the send_email_digest deprecation entry with the new digest scheduling settings.
  • Documented new operator-facing notification settings: instance-level preference overrides, the immediate-email buffer window, and ORA reminder notifications.
  • Added the "Frontend-base" and "Loading External Scripts" sections, which existed on the wiki but were missing from these notes.

Supporting information

Refs openedx/wg-build-test-release#610

@openedx-webhooks openedx-webhooks added the open-source-contribution PR author is not from Axim or 2U label Jul 20, 2026
@openedx-webhooks

Copy link
Copy Markdown

Thanks for the pull request, @feoh!

This repository is currently maintained by @openedx/wg-maintenance-docs.openedx.org.

Once you've gone through the following steps feel free to tag them in a comment and let them know that your changes are ready for engineering review.

🔘 Get product approval

If you haven't already, check this list to see if your contribution needs to go through the product review process.

  • If it does, you'll need to submit a product proposal for your contribution, and have it reviewed by the Product Working Group.
    • This process (including the steps you'll need to take) is documented here.
  • If it doesn't, simply proceed with the next step.
🔘 Provide context

To help your reviewers and other members of the community understand the purpose and larger context of your changes, feel free to add as much of the following information to the PR description as you can:

  • Dependencies

    This PR must be merged before / after / at the same time as ...

  • Blockers

    This PR is waiting for OEP-1234 to be accepted.

  • Timeline information

    This PR must be merged by XX date because ...

  • Partner information

    This is for a course on edx.org.

  • Supporting documentation
  • Relevant Open edX discussion forum threads
🔘 Get a green build

If one or more checks are failing, continue working on your changes until this is no longer the case and your build turns green.

Details
Where can I find more information?

If you'd like to get more details on all aspects of the review process for open source pull requests (OSPRs), check out the following resources:

When can I expect my changes to be merged?

Our goal is to get community contributions seen and reviewed as efficiently as possible.

However, the amount of time that it takes to review and merge a PR can vary significantly based on factors such as:

  • The size and impact of the changes that it introduces
  • The need for product review
  • Maintenance status of the parent repository

💡 As a result it may take up to several weeks or months to complete a review and merge your PR.

feoh added 2 commits July 20, 2026 12:21
Populate the Verawood dev/operator release notes with breaking changes,
deprecations & removals, Aspects analytics, and administrators &
operators sections.
Integrate additions and corrections made to the Verawood Operator
Release Notes wiki page since the notes were first drafted here.

- Correct the Upgrade/upsell widget entry: it is enabled by default
  in Verawood, and the config keys and slot names it documented were
  out of date.
- Note that notifications and notification emails are now enabled by
  default via new opt-out waffle flags.
- Document removal of course-level notification preferences, the
  is_core preference flag, and the V2 notification preferences
  config API.
- Expand the send_email_digest deprecation entry with the new daily
  and weekly digest scheduling settings.
- Document new operator-facing notification settings: instance-level
  preference overrides, the immediate-email buffer window, and ORA
  reminder notifications.
- Add the Frontend-base and Loading External Scripts sections, which
  were present on the wiki page but missing from these notes.

Refs: https://openedx.atlassian.net/wiki/spaces/COMM/pages/5331222534/Verawood+-+Operator+Release+Notes
Refs openedx/wg-build-test-release#610
@feoh
feoh force-pushed the cpatti/verawood-release-notes branch from 1c03c6f to 1d2d1bf Compare July 20, 2026 16:21
@mphilbrick211 mphilbrick211 moved this from Needs Triage to Ready for Review in Contributions Jul 20, 2026
Comment thread source/community/release_notes/verawood/dev_op_release_notes.rst Outdated
Comment thread source/community/release_notes/verawood/dev_op_release_notes.rst
Co-authored-by: Maria Grimaldi (Majo) <maria.grimaldi@edunext.co>
<https://github.com/openedx/openedx-tutor-plugins/tree/main/plugins/tutor-contrib-google-analytics>`_.

Settings and Toggles
********************

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we include this section of migrations to be aware of? mariajgrimaldi@43bf8b9

FYI @bradenmacdonald

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like this was added above in section "Migrations to be aware of" ?

@mariajgrimaldi

Copy link
Copy Markdown
Member

Since Chris is out on vacation, @pdpinch @sarina, do you think we can merge this? I can open a new PR with the changes I proposed here mariajgrimaldi@43bf8b9

@mariajgrimaldi
mariajgrimaldi requested review from pdpinch and sarina July 27, 2026 14:44
mariajgrimaldi and others added 2 commits July 27, 2026 16:10
Adds a new entry under Administrators & Operators covering the
authz.enable_course_authoring waffle flag (course/org/global
levels), the migration and rollback management commands, the
opt-in automatic migration setting, the audit trail, and a known
caveat around Admin Console course visibility, including the
flag-resolution behavior added in
openedx/frontend-app-admin-console#176.
Several migrations in this release touch existing data at scale, run
automatically without an explicit opt-in, or can fail depending on
instance data history. Consolidate the existing course-ID case
sensitivity callout with four newly identified ones (MariaDB UUID
conversion, AuthZ course-authoring role migration, catalog course/run
backfill, and enterprise academies auto-enable) into one dedicated,
top-level section so operators can find them ahead of an upgrade.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@feoh

feoh commented Jul 27, 2026

Copy link
Copy Markdown
Contributor Author

@mariajgrimaldi waves from vacation - Took but a few seconds to integrate your suggestions.

down periscipe

@mariajgrimaldi

Copy link
Copy Markdown
Member

you rock, @feoh! Thank youuu

@mariajgrimaldi mariajgrimaldi left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Thanks a lot!!!

@sarina sarina left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Renders great! Just a few small changes requested.

Comment thread source/community/release_notes/verawood/dev_op_release_notes.rst Outdated
<https://github.com/openedx/openedx-tutor-plugins/tree/main/plugins/tutor-contrib-google-analytics>`_.

Settings and Toggles
********************

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like this was added above in section "Migrations to be aware of" ?

Comment thread source/community/release_notes/verawood/dev_op_release_notes.rst Outdated
Comment thread source/community/release_notes/verawood/dev_op_release_notes.rst Outdated
@sarina

sarina commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

I'm going to apply the fixes and merge into a separate branch so I can add it to the release note stacked pr

@sarina
sarina changed the base branch from main to verawood/operator-rns July 28, 2026 16:49
Co-authored-by: Sarina Canelake <sarina@axim.org>
@sarina
sarina merged commit 7a9fa75 into openedx:verawood/operator-rns Jul 28, 2026
1 of 2 checks passed
@github-project-automation github-project-automation Bot moved this from Ready for Review to Done in Contributions Jul 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

open-source-contribution PR author is not from Axim or 2U

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

5 participants