Skip to content

Add information on managing user permissions for Libraries#1080

Merged
sarina merged 1 commit into
mainfrom
sarina/taxonomies-permissions
May 30, 2025
Merged

Add information on managing user permissions for Libraries#1080
sarina merged 1 commit into
mainfrom
sarina/taxonomies-permissions

Conversation

@sarina
Copy link
Copy Markdown
Contributor

@sarina sarina commented May 21, 2025

I'm trying to update all of our docs - the docs reviewers are marking these pages as Failed, because they don't know what permissions they need. This PR adds notes to Libraries How-Tos that explain what permissions are needed to perform various actions, and also updates the page about Library user permissions to be more explicit about each permission.

@sarina
Copy link
Copy Markdown
Contributor Author

sarina commented May 21, 2025

@jswope00 this PR addresses the problems @leiramagpantay was facing with testing these pages. Could you review that the notes regarding permissions levels make sense to you, so that we can get these pages tested by a user with the proper permissions?

@jmakowski1123
Copy link
Copy Markdown
Contributor

jmakowski1123 commented May 21, 2025

Libraries have the concept of teams, and there are 3 out-of-the-box roles on a Library Team:

-Author: Can view library content, create new library content, edit library content, use library content in courses. They can also create collections, add and remove content from collections. They can add and remove tags from content and from collections. Authors can also see who else is on the team for any library that they are an author on. Library authors are very similar roles to course staff on the course side.

-Admins: Have all the permissions of authors, but can also add and remove Library Team members. Only admins can delete entire libraries. Entire libraries can also be toggled to read-only, and only admins have the permission to switch that toggle.

-View-only: Team members who have view-only permissions on the content in a library, but who cannot create new content or edit content. View only includes the ability to search in libraries, and apply filters and sorts.

In terms of intersections with already-existing roles, if you have global admin access on the platform, you also have library admin permissions.

Library-level permissions are managed from within any given library. They are accessible via the Library sidebar, under "Manage Access". From here, admins can add or remove library team members and change the read status of the library, and any library author can see who else is on the library team.

Screen Shot 2025-05-21 at 2 58 03 PM

@sarina
Copy link
Copy Markdown
Contributor Author

sarina commented May 22, 2025

@jmakowski1123 could you review this page? https://docsopenedxorg--1080.org.readthedocs.build/en/1080/educators/how-tos/course_development/add_users_to_libraries.html

@sarina
Copy link
Copy Markdown
Contributor Author

sarina commented May 28, 2025

Add permissions note to Taxonomy how-tos

Apply suggestions from Jenna's review
@sarina sarina force-pushed the sarina/taxonomies-permissions branch from ab86c8a to 168ff46 Compare May 30, 2025 20:28
@sarina sarina enabled auto-merge (rebase) May 30, 2025 20:29
@sarina sarina merged commit ec6bc6c into main May 30, 2025
2 checks passed
@sarina sarina deleted the sarina/taxonomies-permissions branch May 30, 2025 20:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants