Registry team access bulk #1047

ngrayluna · 2025-01-30T18:08:03Z

Registry bulk team access doc.

Adds info on how to add a team (in addition to a single user)
Moves info about "registry visibility" out of access page so as to not confuse users on registry visibility vs user roles.
Adds info on how W&B attempts to resolve role conflicts.

Ready for tech review. Will ping Docs Team (i.e. Matt) for review when tech review is done or near complete.

Confirm that tests pass and this change is ready for review:

Local hugo serve
Local vale ./content

cloudflare-workers-and-pages · 2025-01-30T23:32:42Z

Deploying docs with Cloudflare Pages

Latest commit:	`3964c0c`
Status:	✅ Deploy successful!
Preview URL:	https://5187c756.docodile.pages.dev
Branch Preview URL:	https://registry-team-access-bulk.docodile.pages.dev

View logs

…o registry_team_access_bulk

ngrayluna · 2025-02-06T17:09:19Z

PR ready for tech review.

content/guides/models/registry/configure_registry.md

ibindlish · 2025-02-07T17:10:17Z

content/guides/models/registry/configure_registry.md

+
+Each user in a registry has a specific *registry role*. Registry roles determine what users can do in a given registry.
+
+Registry administrators can assign or modify team and user roles in a registry. See [Configure user roles in a registry]({{< relref "configure_registry.md#configure-user-roles-in-a-registry" >}}) for more information.

 {{% alert title="W&B role types" %}}


Do we have docs on Team roles vs Project roles already? Wondering if that part of the docs describes role assignments in those 2 scopes as role types. If they exist already, it might be better to maintain consistency. Wdyt?

But basically, team roles and registry roles are just different contexts in which users can be assigned roles, and they are independent of each other.

I don't believe we have a doc on team roles vs project roles...

For my own understanding, where can I find more info on this? :)?

I think this covers it in some sense https://docs.wandb.ai/guides/hosting/iam/access-management/restricted-projects/#project-level-roles, but lmk offline if you'd like to sync on it!

content/guides/models/registry/configure_registry.md

content/guides/models/registry/create_registry.md

ibindlish

lgtm - thank you for the quick response to feedback!

content/guides/models/registry/configure_registry.md

github-actions · 2025-02-10T22:13:57Z

Images automagically compressed by Calibre's image-actions ✨

Compression reduced images by 44.5%, saving 72.03 KB.

Filename	Before	After	Improvement	Visual comparison
`assets/images/registry/role_conflict.png`	161.88 KB	89.85 KB	-44.5%	View diff

439 images did not require optimisation.

mdlinville

Some copyedit suggestions and some questions. Please skip anything that isn't helpful!

content/guides/models/registry/configure_registry.md

mdlinville · 2025-02-11T17:18:16Z

content/guides/models/registry/configure_registry.md

+
+1. Navigate to the Registry App at https://wandb.ai/registry/.
+2. Select the registry you want to add a user or team to.
+3. Click on the gear icon on the upper right hand corner to access the registry settings.


Suggested change

3. Click on the gear icon on the upper right hand corner to access the registry settings.

3. Click the Registry's gear icon on the upper right of the page.

mdlinville · 2025-02-11T17:51:43Z

content/guides/models/registry/create_registry.md

+## Configure the visibility of a custom registry
+
+A team administrator or registry administrator can assign the visibility of a custom registry during or after the creation of a custom registry. 


Suggested change

A team administrator or registry administrator can assign the visibility of a custom registry during or after the creation of a custom registry.

A team administrator or registry administrator can assign the visibility of a custom registry while creating it or afterward.

content/guides/models/registry/create_registry.md

mdlinville · 2025-02-11T21:34:08Z

assets/images/registry/add_team_registry.gif

Not for this PR, but I'd like to see some of these images more tightly cropped. This one could lose half of its width on the left-hand side and still give enough context on how to move around the UI.

mdlinville · 2025-02-11T21:35:31Z

content/guides/models/registry/configure_registry.md

@@ -7,107 +7,121 @@ title: Configure registry access
 weight: 3
 ---

-<!-- A registry, and the linked artifacts inside a registry, belong to an organization. This means that teams within an organization can publish and consume artifacts linked to a registry, if that team has correct access control. -->
+Registry admins can [configure registry roles]({{< relref "configure_registry.md#configure-registry-roles" >}}), [add users]({{< relref "configure_registry.md#add-a-user-or-a-team-to-a-registry" >}}), or [remove users]({{< relref "configure_registry.md#remove-a-user-or-team-from-a-registry" >}}) from a registry by configuring the registry's settings.


Suggested change

Registry admins can [configure registry roles]({{< relref "configure_registry.md#configure-registry-roles" >}}), [add users]({{< relref "configure_registry.md#add-a-user-or-a-team-to-a-registry" >}}), or [remove users]({{< relref "configure_registry.md#remove-a-user-or-team-from-a-registry" >}}) from a registry by configuring the registry's settings.

A Registry admin can [configure registry roles]({{< relref "configure_registry.md#configure-registry-roles" >}}), [add users]({{< relref "configure_registry.md#add-a-user-or-a-team-to-a-registry" >}}), and [remove users]({{< relref "configure_registry.md#remove-a-user-or-team-from-a-registry" >}}) from a registry.

I think it reads better in the singular. I changed the "or" to an "and" because the admin can do all of them. And the following sections show how to do these actions (by modifying the Registry's settings) so I removed that clause. WDYT?

mdlinville · 2025-02-11T21:37:03Z

content/guides/models/registry/configure_registry.md


-Registry admins can limit who can access a registry by navigating to a registry's settings and assigning a user's role to [Admin, Member, or Viewer]({{< relref "#registry-roles-permissions" >}}). Users can have different roles in different registries. For example, a user can have a view role in "Registry A" and a member role in the "Registry B". 
+## Add a user or a team to a registry


Suggested change

## Add a user or a team to a registry

## Add a user or team to a registry

mdlinville · 2025-02-11T21:37:58Z

content/guides/models/registry/configure_registry.md

-Registry admins can limit who can access a registry by navigating to a registry's settings and assigning a user's role to [Admin, Member, or Viewer]({{< relref "#registry-roles-permissions" >}}). Users can have different roles in different registries. For example, a user can have a view role in "Registry A" and a member role in the "Registry B". 
+## Add a user or a team to a registry
+
+Registry admins can add individual users or entire teams to a registry. To add a user or team to a registry:


Suggested change

Registry admins can add individual users or entire teams to a registry. To add a user or team to a registry:

A Registry admin can add users or teams to a registry:

mdlinville · 2025-02-11T21:39:25Z

content/guides/models/registry/configure_registry.md

+4. Navigate to the **Registry access** section.
+5. Click on the **Add access** button.


Suggested change

4. Navigate to the **Registry access** section.

5. Click on the **Add access** button.

4. In the to the **Registry access** sectio, click **Add access**.

This reverts commit 1867b27.

Reverts #1047

Note: This is identical to #1047 Why does this PR exist? I merged [PR 1047](#1047 ) before pushing local changes. Once merged, I could not reopen 1047. So, I am creating this new PR to push all changes in 1047, Registry bulk team access doc. Adds info on how to add a team (in addition to a single user) Moves info about "registry visibility" out of access page so as to not confuse users on registry visibility vs user roles. Adds info on how W&B attempts to resolve role conflicts. --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

ngrayluna added 4 commits January 29, 2025 08:34

WIP

5d0606b

WIP. Added info on inheritance

5b5d4da

Replaced admin with longer form

5759cdd

Merge branch 'main' into registry_team_access_bulk

f1e0b8c

ngrayluna added 5 commits January 30, 2025 16:59

More edits

d08153e

Merge branch 'registry_team_access_bulk' of github.com:wandb/docs int…

0fbb915

…o registry_team_access_bulk

Moved redundant text

843e540

Merge branch 'main' into registry_team_access_bulk

70c456e

Small word edits

4d5d805

ngrayluna marked this pull request as ready for review February 6, 2025 17:09

ngrayluna requested a review from a team as a code owner February 6, 2025 17:09

ibindlish requested changes Feb 6, 2025

View reviewed changes

content/guides/models/registry/configure_registry.md Outdated Show resolved Hide resolved

content/guides/models/registry/configure_registry.md Outdated Show resolved Hide resolved

content/guides/models/registry/configure_registry.md Outdated Show resolved Hide resolved

Added feedback

c2f08c2

ngrayluna requested a review from ibindlish February 6, 2025 23:54

ibindlish requested changes Feb 7, 2025

View reviewed changes

mdlinville requested changes Feb 7, 2025

View reviewed changes

Added feedback

306c9b3

ngrayluna requested review from mdlinville and ibindlish February 7, 2025 22:13

Feedback

2c9f381

ibindlish approved these changes Feb 7, 2025

View reviewed changes

Feedback from review

d4d36b3

ngrayluna requested a review from noaleetz February 7, 2025 22:51

noaleetz approved these changes Feb 8, 2025

View reviewed changes

ngrayluna and others added 2 commits February 10, 2025 14:11

Added PM feedback and added images

20bee61

Optimised images with calibre/image-actions

4294168

mdlinville requested changes Feb 11, 2025

View reviewed changes

ngrayluna requested a review from mdlinville February 11, 2025 21:22

mdlinville approved these changes Feb 11, 2025

View reviewed changes

Merge branch 'main' into registry_team_access_bulk

3964c0c

ngrayluna merged commit 1867b27 into main Feb 11, 2025
7 checks passed

ngrayluna deleted the registry_team_access_bulk branch February 11, 2025 22:03

ngrayluna added a commit that referenced this pull request Feb 11, 2025

Revert "Registry team access bulk (#1047)"

87f64cc

This reverts commit 1867b27.

ngrayluna mentioned this pull request Feb 11, 2025

Revert "Registry team access bulk" #1093

Merged

ngrayluna restored the registry_team_access_bulk branch February 11, 2025 22:13

ngrayluna added a commit that referenced this pull request Feb 11, 2025

Revert "Registry team access bulk" (#1093)

537c0cb

Reverts #1047

ngrayluna mentioned this pull request Feb 11, 2025

Duplicate: Updated registry team access bulk #1094

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Registry team access bulk #1047

Registry team access bulk #1047

ngrayluna commented Jan 30, 2025 •

edited

Loading

cloudflare-workers-and-pages bot commented Jan 30, 2025 •

edited

Loading

ngrayluna commented Feb 6, 2025

ibindlish Feb 7, 2025

ngrayluna Feb 7, 2025

ibindlish Feb 7, 2025

ibindlish left a comment

github-actions bot commented Feb 10, 2025

mdlinville left a comment

mdlinville Feb 11, 2025

mdlinville Feb 11, 2025

mdlinville Feb 11, 2025

mdlinville Feb 11, 2025

mdlinville Feb 11, 2025

mdlinville Feb 11, 2025

mdlinville Feb 11, 2025

	3. Click on the gear icon on the upper right hand corner to access the registry settings.
	3. Click the Registry's gear icon on the upper right of the page.

		## Configure the visibility of a custom registry

		A team administrator or registry administrator can assign the visibility of a custom registry during or after the creation of a custom registry.

	Registry admins can [configure registry roles]({{< relref "configure_registry.md#configure-registry-roles" >}}), [add users]({{< relref "configure_registry.md#add-a-user-or-a-team-to-a-registry" >}}), or [remove users]({{< relref "configure_registry.md#remove-a-user-or-team-from-a-registry" >}}) from a registry by configuring the registry's settings.
	A Registry admin can [configure registry roles]({{< relref "configure_registry.md#configure-registry-roles" >}}), [add users]({{< relref "configure_registry.md#add-a-user-or-a-team-to-a-registry" >}}), and [remove users]({{< relref "configure_registry.md#remove-a-user-or-team-from-a-registry" >}}) from a registry.


		Registry admins can limit who can access a registry by navigating to a registry's settings and assigning a user's role to [Admin, Member, or Viewer]({{< relref "#registry-roles-permissions" >}}). Users can have different roles in different registries. For example, a user can have a view role in "Registry A" and a member role in the "Registry B".
		## Add a user or a team to a registry

	## Add a user or a team to a registry
	## Add a user or team to a registry

	Registry admins can add individual users or entire teams to a registry. To add a user or team to a registry:
	A Registry admin can add users or teams to a registry:

		4. Navigate to the Registry access section.
		5. Click on the Add access button.

	4. Navigate to the Registry access section.
	5. Click on the Add access button.
	4. In the to the Registry access sectio, click Add access.

Registry team access bulk #1047

Registry team access bulk #1047

Conversation

ngrayluna commented Jan 30, 2025 • edited Loading

cloudflare-workers-and-pages bot commented Jan 30, 2025 • edited Loading

Deploying docs with Cloudflare Pages

ngrayluna commented Feb 6, 2025

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ibindlish left a comment

Choose a reason for hiding this comment

github-actions bot commented Feb 10, 2025

mdlinville left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

ngrayluna commented Jan 30, 2025 •

edited

Loading

cloudflare-workers-and-pages bot commented Jan 30, 2025 •

edited

Loading