Skip to content

Docs: Add instructions for managing organization owners#12760

Open
Copilot wants to merge 4 commits intomainfrom
copilot/docs-add-owner-instruction
Open

Docs: Add instructions for managing organization owners#12760
Copilot wants to merge 4 commits intomainfrom
copilot/docs-add-owner-instruction

Conversation

Copy link
Contributor

Copilot AI commented Feb 5, 2026

Documentation: Add Instructions for Adding Owners to Organizations

This PR adds documentation about how to add owners to an organization, addressing the missing documentation identified in the issue.

Summary of Changes:

  • Review existing documentation structure and content
  • Add section on adding/removing owners to the manage-read-the-docs-teams.rst guide
  • Update the organizations.rst file with a reference to managing owners
  • Verify the documentation builds correctly
  • Request code review
  • Address review feedback: correct UI navigation steps and add permission requirement
  • Fix button label to "Invite owner" and add Settings step for removing owners

Files Modified:

  1. docs/user/guides/manage-read-the-docs-teams.rst:
    • Added comprehensive instructions for managing organization owners
    • Corrected steps to include Settings → Owners → Invite owner workflow
    • Added note that user must be an owner to add another owner
    • Fixed button label from "Add owner" to "Invite owner"
    • Added Settings step to removing owners workflow for consistency
  2. docs/user/commercial/organizations.rst: Updated reference to reflect expanded guide scope

The documentation now provides accurate, step-by-step instructions for adding and removing organization owners.

Original prompt

This section details on the original issue you should resolve

<issue_title>Docs: add instruction about adding owner to organization</issue_title>
<issue_description>This should be documented in at least https://docs.readthedocs.com/platform/stable/commercial/organizations.html, or maybe have a page like https://docs.readthedocs.com/platform/stable/guides/manage-read-the-docs-teams.html</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: stsewd <4975310+stsewd@users.noreply.github.com>
Copilot AI changed the title [WIP] Add documentation for adding owner to organization Docs: Add instructions for managing organization owners Feb 5, 2026
Copilot AI requested a review from stsewd February 5, 2026 23:27
@read-the-docs-community
Copy link

read-the-docs-community bot commented Feb 5, 2026

Documentation build overview

📚 docs | 🛠️ Build #31294969 | 📁 Comparing e44a0aa against latest (86f99d6)


🔍 Preview build

Show files changed (5 files in total): 📝 5 modified | ➕ 0 added | ➖ 0 deleted
File Status
commercial/organizations.html 📝 modified
guides/manage-read-the-docs-teams.html 📝 modified
guides/managing-maintainers.html 📝 modified
guides/set-up-single-sign-on-saml.html 📝 modified
guides/setup-single-sign-on-google-email.html 📝 modified

…ement

Co-authored-by: stsewd <4975310+stsewd@users.noreply.github.com>
Copilot AI requested a review from stsewd February 5, 2026 23:32
@stsewd
Copy link
Member

stsewd commented Feb 5, 2026

@copilot address feedback.

Co-authored-by: stsewd <4975310+stsewd@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Feb 5, 2026

@copilot address feedback.

Addressed all feedback in commit e44a0aa.

Copilot AI requested a review from stsewd February 5, 2026 23:38
@stsewd stsewd marked this pull request as ready for review February 9, 2026 17:35
@stsewd stsewd requested a review from a team as a code owner February 9, 2026 17:35
@stsewd stsewd requested a review from agjohnson February 9, 2026 17:35
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.

Docs: add instruction about adding owner to organization

2 participants