-
Notifications
You must be signed in to change notification settings - Fork 115
Add "Open Team Invite" section to Teams documentation #569
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from 6 commits
3f581ff
7210d8f
43e39bd
c3224b4
722d2eb
4ee43a7
61b16e7
d3025d4
d32791f
f49527a
35d9e75
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -6,7 +6,6 @@ categories: [Identity] | |
tags: [teams] | ||
--- | ||
|
||
|
||
Organizations are the basic unit of multi-tenancy inside of Layer5 Cloud. Organizations can have any number of teams. Teams can have any number of users. Users can belong to any number of teams. Users may belong to any number of organizations. | ||
|
||
Outside of grouping users together, teams offer control access to workspaces and to workspace resources such as environments and managed and unmanaged connections. | ||
|
@@ -19,8 +18,35 @@ A team is simply a group that an administrator can create in the Google Admin co | |
|
||
Below the top-level organization, you can add as many teams as you want - at the same level. Hierarchal teams are not currently supported. When you change a setting at the higher level organization, the settings for all child teams that inherit that setting also change. Custom settings at the team level, however, remain unchanged. | ||
|
||
Learn more about the [organizational structure](/cloud/identity). | ||
>Learn more about the [organizational structure](/cloud/identity). | ||
|
||
{{< alert type="info" title="Note">}} | ||
{{< alert type="info" title="Team Ownership">}} | ||
If you are the current team owner, you can’t remove yourself from the team until you transfer ownership to another team administrator. | ||
{{< /alert >}} | ||
{{< /alert >}} | ||
|
||
## Open Team Invite | ||
|
||
The "Open Team Invite" feature allows administrators to enable a specific invitation method for users to join a particular team. This is intended to function like an [Open Org Invite Link](https://docs.layer5.io/cloud/identity/users/user-management/), but for a specific team, providing a direct way to invite members rather than adding them manually. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. "intended to"? Rather, "does". |
||
|
||
 | ||
|
||
### Why Use Open Team Invite | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Refine your AI output, please. Let's not call it "Open Team Invite". |
||
|
||
* **Effortless Onboarding to Teams:** Provides a single invitation link that seamlessly guides users through account creation (if new), organization membership, and directly into the specific team. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. This is marketing fluff and AI generated content that is of little value. These are docs, not marketing website. Focus on how the feature works, when to use it, best practices of using it and any caveats of its use. |
||
* **Targeted Invitations:** Allows for precise invitations to particular teams using a dedicated, shareable link. | ||
|
||
{{< alert type="info" title="For Organization-Specific Invitations">}} | ||
If your goal is to invite users only to a specific organization (and not directly to a team as part of the same invitation), please refer to the documentation on [Open Org Invite Link and User Management](https://docs.layer5.io/cloud/identity/users/user-management/). | ||
zihanKuang marked this conversation as resolved.
Show resolved
Hide resolved
|
||
{{< /alert >}} | ||
|
||
### How Open Team Invite Works | ||
|
||
1. **Copy Team Invite Link:** After clicking the relevant UI element, the link is copied to your clipboard.[^1] | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. "After clicking the relevant UI element," - - too abstract. Do we really need to tell our users that when they click "the relevant UI element" (the copy link button) that the link is then copied to clipboard? 🫤 Less AI, more Zihan. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The current UI still uses a checkbox,and it hasn't been fixed. I'm unsure what the intended UI element should be. |
||
2. **Share Link:** Distribute this copied "Team Invite Link" to the individuals you intend to invite to the team. | ||
3. **User Onboarding with Team Invite Link:** When a user clicks the "Team Invite Link," the system handles their onboarding as follows: | ||
* **If the user has no system account:** They are guided through the account registration process. Upon successful registration, they are automatically added to **both** the relevant organization and the specific team. | ||
* **If the user has a system account but is not in the target organization:** Upon using the link, they are added to **both** the organization and the specific team. | ||
* **If the user is already in the organization (and has an account):** Upon using the link, they are added to the specific team. | ||
4. **Manual Alternative:** As an alternative, administrators can always manually add existing organization members to a team. | ||
|
||
[^1]: If the direct way to copy this link isn't fully visible or working correctly in the current version, this is a known issue that we plan to fix in an upcoming update. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"a specific invitation method" - perhaps, this could be made into less abstract phrasing.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The current UI still uses a checkbox,and it hasn't been fixed. I'm unsure what the intended UI element should be.