Skip to content

Conversation

@scoti-knock
Copy link
Contributor

Updates to managing account members documentation

Updates managing members docs for improved clarity and style guide alignment.

Changes:

  • Restructured content with improved hierarchy (Adding membersInviting members, Managing invitations, Enabling auto-join) and shortened header names to create a clean (not wrapping) TOC.
  • Consolidated multiple inline callouts into a single note at the end.
  • Updated screenshot of members page to reflect the new dashboard design.
  • Fixed grammar and formatting inconsistencies where found.

Note: I've intentionally referred to permissions broadly ("with appropriate permissions") rather than using role names. I did this in hopes that this page doesn't become outdated when the RBAC project is released.

@linear
Copy link

linear bot commented Jan 5, 2026

@vercel
Copy link

vercel bot commented Jan 5, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
docs Ready Ready Preview, Comment Jan 5, 2026 11:07pm

### Removing members

Members can be removed from an account from the three dot menu. Removing a member will revoke their access to Knock and immediately invalidate any session associated with the user. Additionally, the member will also be sent an email letting them know that they have been removed from the account.
Members with appropriate [permissions](/manage-your-account/roles-and-permissions) can remove other members from an account by clicking the "Remove member" option found in the three-dot menu. Removing a member will revoke their access to Knock and immediately invalidate any session associated with the member. The removed member will receive an email informing them of the change in account access.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Note from PR summary: I've intentionally referred to permissions broadly ("with appropriate permissions") rather than using role names. I did this in hopes that this page doesn't become outdated when the RBAC project is released.

Comment on lines 103 to 105
Users can't change their own roles or remove themselves from a Knock
account and accounts must have at least one <code>owner</code> at all
times.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Users can't change their own roles or remove themselves from a Knock
account and accounts must have at least one <code>owner</code> at all
times.
Users can't change their own roles or remove themselves from a Knock
account, and accounts must have at least one <code>owner</code> at all
times.

There's something that reads funny about this that I can't quite put my finger on; I think it's the "or" followed by the "and". Alternatively:

Suggested change
Users can't change their own roles or remove themselves from a Knock
account and accounts must have at least one <code>owner</code> at all
times.
Users can't change their own roles or remove themselves from a Knock
account. Accounts must have at least one <code>owner</code> at all
times.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yeah I was back and forth on this too — I'll push an update

scoti-knock and others added 4 commits January 5, 2026 17:36
@scoti-knock scoti-knock merged commit 0c98f24 into main Jan 5, 2026
4 of 5 checks passed
@scoti-knock scoti-knock deleted the sd-KNO-10998-updating-members-callouts branch January 5, 2026 23:07
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