Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
3baab3f
docs: add Roles and Permissions Console release notes for Verawood
BryanttV Jul 29, 2026
361c5c0
docs: add Course Authoring Roles release notes for Verawood
BryanttV Jul 29, 2026
bdfdf06
docs: add Manage Course Authoring Roles how-to
BryanttV Jul 29, 2026
c6a67ef
docs: document new course authoring roles in Guide to Course Team Roles
BryanttV Jul 29, 2026
734a6fe
docs: note new console option in Add Course Team Members
BryanttV Jul 29, 2026
10f8add
docs: update Manage Library User Access for the unified Assign Role w…
BryanttV Jul 29, 2026
da6f4f7
docs: fix role name and add prerequisite note in Create New Library
BryanttV Jul 29, 2026
58034cc
docs: add canonical Use Roles and Permissions Console how-to
BryanttV Jul 29, 2026
f2e4761
docs: add new images for educator how-tos on roles and permissions
BryanttV Jul 29, 2026
cf3361e
docs: add verawood console and course authoring roles pages to toctrees
BryanttV Jul 29, 2026
f24f64e
docs: enhance Course Team Roles documentation with formatting updates
BryanttV Jul 29, 2026
0813eda
Update Roles and Permissions release note
sarina Jul 30, 2026
4c42d10
Update release note with additional detail
sarina Jul 30, 2026
f06b1e4
Update cross references
sarina Jul 30, 2026
dccb1f3
Respond to code review
sarina Jul 30, 2026
1ea6765
Remove unused image files
sarina Jul 30, 2026
de941b6
Fix build errors
sarina Jul 30, 2026
51d475b
Update screenshots
sarina Jul 30, 2026
7f5e71f
Clarify language around the console view screenshot
sarina Jul 30, 2026
9521b63
Clarify global scope users don't appear
sarina Jul 30, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
305 changes: 156 additions & 149 deletions source/community/release_notes/verawood/dev_op_release_notes.rst

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ Open edX Verawood Release - Product Release Notes
.. toctree::
:maxdepth: 1

verawood_rp
ai_extension_framework
new_instructor_dashboard
verawood_lti_cert
Expand All @@ -23,5 +24,5 @@ in the :ref:`Verawood Dev Notes`.
+--------------+-------------------------------+----------------+--------------------------------+
| Review Date | Working Group Reviewer | Release |Test situation |
+--------------+-------------------------------+----------------+--------------------------------+
| | | | |
| 2025-07-30 | Product WG | Verawood | Pass |
+--------------+-------------------------------+----------------+--------------------------------+
Original file line number Diff line number Diff line change
Expand Up @@ -48,4 +48,4 @@ View the `1EdTech listing for the Open edX platform here
| Review Date | Working Group Reviewer | Release |Test situation |
+--------------+-------------------------------+----------------+--------------------------------+
| 2026-07-03 | Aamir Ayub | Verawood | Pass |
+--------------+-------------------------------+----------------+--------------------------------+
+--------------+-------------------------------+----------------+--------------------------------+
144 changes: 144 additions & 0 deletions source/community/release_notes/verawood/verawood_rp.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,144 @@
.. _Introducing More Granular Team Management:

Introducing More Granular Team Management
##########################################

Easily manage user access across multiple parts of the platform from a single
view. The Verawood release extends the :ref:`administrative console <Ulmo
console>`, introduced in the previous release for managing permissions over
:ref:`Content Libraries <Add users to Libraries>`. Now renamed to the "Roles and
Permissions Console", it adds new roles that can be applied across Studio.

.. figure:: /_images/educator_how_tos/console_course_team_members.png
:alt: The Team Members tab of the Roles and Permissions console, showing course team members

The Team Members tab of the Roles and Permissions console. This is the Admin
view; you only see the role assignments associated with the course(s) and/or
librar(ies) you have access to, not any other roles those users may have
on other organizations, courses, or libraries.

You can now assign two new roles, Course Admin or Course Staff, to one or
multiple users and apply them at multiple levels (a specific organization,
course, or library) — all in a single action. Granting a role at
the organization level covers both existing courses and any courses created in
that organization afterward.

This feature is opt-in and disabled by default. It can be enabled across your
whole instance, or for one or more specific organizations or courses, and must be
:ref:`enabled by your site administrator <Enabling RBAC in Verawood>`.

New User Roles
**************

**Course Admin** is the new-system equivalent of the legacy Admin role: course
team management through the Roles and Permissions console and full authoring
access in Studio.

**Course Staff** is the new-system equivalent of the legacy Staff role: full
course lifecycle management in Studio.

**Course Admin** and **Course Staff** are the new system's equivalents of the
legacy Admin and Staff roles for a course: same responsibilities, new assignment
mechanism. For a full breakdown of what each role can do, see :ref:`Course Authoring Roles
Under the New Roles and Permissions System <New System Course Authoring Roles>`.

What's Available in Verawood
*****************************

- **Unified interface**: the Roles and Permissions console displays all role
assignments in one place, filterable by role, organization, and scope.
- **Assign Role wizard**: assign a role to multiple users and multiple scopes in
a single action.
- **Organization-level assignment**: grant a role to a user across an entire
organization, including scopes created later.
- **User audit view**: shows a user's roles across every course and library you
have permission to manage.
- **Filtered entry points**: the console opens filtered to the context you came
from, unfiltered from the Studio home page, or filtered to a single course or
library when opened from there.

Scope and Impact
*****************

When this feature is enabled, the platform supports both the legacy Instructor
Dashboard roles (Admin, Staff, Limited Staff) and the new Course Admin / Course
Staff roles at the same time. New roles apply according to the scope where the
flag is enabled — platform, organization, or course.

The Roles and Permissions console is a place where you can examine the users who
have access to your system - their “role”, and also where that applies (which
“organization” it applies to, as well as the “scope” of the role - specific
course(s) or librar(ies)). For example, in the following screenshot, we see two
users - Jhon_Doe, who has the "Course Admin” role - this role applies across one
organization and one course. The next user, “KellyKapoor”, has the “Course
Editor” role applied over a different course in a different organization.

.. image:: /_images/release_notes/verawood/rp_console_roles.png
:alt: A screenshot illustrating the above paragraph

Note: if you have a role for a course or library, this view allows you to see
users who have roles related to that same course or library. You only see the
role assignments associated with the course(s) and/or librar(ies) you have
access to, not any other roles those users may have on other organizations,
courses, or libraries.

The Roles and Permissions console is where you can examine the users who have
access to your system: their role, which organization it applies to, and the scope
of the role (specific course(s) or librar(ies)). The console also lets you change
or add course and library authoring roles for individual users.

Migration of Existing Course Role Assignments
**********************************************

Verawood includes migration tools to synchronize existing Admin and Staff course
role assignments between the legacy system and the new Roles and Permissions
framework. Depending on how your site is configured, this can happen automatically
when the Course Authoring feature is enabled for a course or organization —
existing Admin and Staff assignments carry over without manual steps. If automatic
migration isn't enabled on your site, your site operator can run the migration
separately. No role assignments are lost in the process.

Not Affected by This Release
*****************************

- Course content and how it is authored. This feature improves how course and
library teams are managed, not what authors create.
- :ref:`Legacy Libraries <Legacy Content Libraries Overview>` (deprecated in
Verawood) that have not yet been :ref:`migrated to Content Libraries <Migrating
Legacy Libraries>`.
- Permissions that apply to LMS functionality and are managed by the Instructor
Dashboard, such as Discussions Forums Admin or Beta Tester.

Future Improvements
********************

In upcoming releases, the Roles and Permissions work is expected to continue in
several directions:

- New Studio roles are planned to separate authoring responsibilities from
managing an active course, and to introduce a read-only role for reviewing
course content in Studio.
- Roles and Permissions management will also expand to the LMS, bringing the same
model to learner-facing features and runtime course management.
- Documentation with design patterns, guides, and extension points for the
community to build on top of the new system are also on the roadmap.


.. seealso::

:ref:`Manage Course Authoring Roles` (how-to)

:ref:`Guide to Course Team Roles` (reference)

:ref:`Add Course Team Members` (how-to)

:ref:`Verawood Product Notes` (reference)


**Maintenance chart**

+--------------+-------------------------------+----------------+--------------------------------+
| Review Date | Working Group Reviewer | Release |Test situation |
+--------------+-------------------------------+----------------+--------------------------------+
| 2025-07-30 | eduNEXT | Verawood | Pass |
+--------------+-------------------------------+----------------+--------------------------------+
Loading