Skip to content

Commit de764a8

Browse files
docs freshness: updates for organization section (#21630)
## Description - Docs freshness updates: - Style guide updates/consistency - Improved UI flow steps, some did not link to DH or Admin Console, and were vague - Added Admin Console steps where missing - Fixed a few incorrect UI flows - ENGDOCS-2357 updates: Updated Insights DD table for new fields ## Related issues or tickets - [ENGDOCS-2348](https://docker.atlassian.net/browse/ENGDOCS-2348) - [ENGDOCS-2357](https://docker.atlassian.net/browse/ENGDOCS-2357) ## Reviews - [ ] Editorial review [ENGDOCS-2348]: https://docker.atlassian.net/browse/ENGDOCS-2348?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ [ENGDOCS-2357]: https://docker.atlassian.net/browse/ENGDOCS-2357?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ --------- Co-authored-by: David Karlsson <[email protected]>
1 parent bd7617d commit de764a8

File tree

7 files changed

+174
-93
lines changed

7 files changed

+174
-93
lines changed
-19.7 KB
Binary file not shown.

content/manuals/admin/organization/general-settings.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ This section describes how to manage organization settings in the Docker Admin C
1111

1212
## Configure general information
1313

14-
General organization information appears on your organization landing page in Docker Hub.
14+
General organization information appears on your organization landing page in the Admin Console.
1515

1616
This information includes:
1717
- Organization Name

content/manuals/admin/organization/insights.md

Lines changed: 18 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -15,36 +15,39 @@ productivity and efficiency across the organization.
1515

1616
Key benefits include:
1717

18-
* Uniform working environment. Establish and maintain standardized
18+
- Uniform working environment. Establish and maintain standardized
1919
configurations across teams.
20-
* Best practices. Promote and enforce usage guidelines to ensure optimal
20+
- Best practices. Promote and enforce usage guidelines to ensure optimal
2121
performance.
22-
* Increased visibility. Monitor and drive adoption of organizational
22+
- Increased visibility. Monitor and drive adoption of organizational
2323
configurations and policies.
24-
* Optimized license use. Ensure that developers have access to advanced
24+
- Optimized license use. Ensure that developers have access to advanced
2525
features provided by a Docker subscription.
2626

2727
## View Insights for organization users
2828

29+
{{< include "admin-early-access.md" >}}
30+
2931
1. Go to the [Admin Console](https://app.docker.com/admin/) and sign in to an
3032
account that is an organization owner.
3133
2. Select your company on the **Choose profile** page.
3234
3. Select **Insights**.
3335
4. On the **Insights** page, select the period of time for the data.
3436

3537
> [!NOTE]
38+
>
3639
> Insights data is not real-time and is updated daily. At the top-right of the
3740
> Insights page, view the **Last updated** date to understand when the data was
3841
> last updated.
3942
4043
You can view data in the following charts:
4144

42-
* [Docker Desktop users](#docker-desktop-users)
43-
* [Builds](#builds)
44-
* [Containers](#containers)
45-
* [Docker Desktop usage](#docker-desktop-usage)
46-
* [Docker Hub images](#docker-hub-images)
47-
* [Extensions](#extensions)
45+
- [Docker Desktop users](#docker-desktop-users)
46+
- [Builds](#builds)
47+
- [Containers](#containers)
48+
- [Docker Desktop usage](#docker-desktop-usage)
49+
- [Docker Hub images](#docker-hub-images)
50+
- [Extensions](#extensions)
4851

4952
### Docker Desktop users
5053

@@ -56,13 +59,12 @@ counts.
5659

5760
The chart contains the following data.
5861

59-
| Data | Description |
62+
| Data | Description |
6063
|:-----------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
61-
| Total active users | The number of users that have actively used Docker Desktop and either signed in with a Docker account that has a license in your organization or signed in to a Docker account with an email address from a domain associated with your organization. <br><br>Users who don’t sign in to an account associated with your organization are not represented in the data. To ensure users sign in with an account associated with your organization, you can [enforce sign-in](/security/for-admins/enforce-sign-in/). |
62-
| Active with license | The number of users that have actively used Docker Desktop and have signed in to a Docker account with a license in your organization. |
63-
| Active without license | The number of users that have actively used Docker Desktop, are linked to a Docker account with an email address from a domain associated with your organization, and don’t have a license assigned to their account. <br><br>Users without a license don’t receive the benefits of your subscription. You can use [domain audit](/security/for-admins/domain-audit/) to identify users without a license. You can also use [Just-in-Time provisioning](/security/for-admins/provisioning/just-in-time/) or [SCIM](/security/for-admins/provisioning/scim/) to help automatically provision users with a license. Note that when SSO is configured and enforced, active without license will be 0. |
64-
| Users opted out of analytics | The number of users that are a member of your organization that have opted out of sending analytics. <br><br>When users opt out of sending analytics, you won't see any of their data in Insights. To ensure that the data includes all users, you can use [Settings Management](/desktop/hardened-desktop/settings-management/) to set `analyticsEnabled` for all your users. |
65-
| Active users (graph) | The view over time for total active users. |
64+
| Active user | The number of users that have actively used Docker Desktop and either signed in with a Docker account that has a license in your organization or signed in to a Docker account with an email address from a domain associated with your organization. <br><br>Users who don’t sign in to an account associated with your organization are not represented in the data. To ensure users sign in with an account associated with your organization, you can [enforce sign-in](/security/for-admins/enforce-sign-in/). |
65+
| Total organization members | The number of users that have used Docker Desktop, regardless of their Insights activity. |
66+
| Users opted out of analytics | The number of users that are a member of your organization that have opted out of sending analytics. <br><br>When users opt out of sending analytics, you won't see any of their data in Insights. To ensure that the data includes all users, you can use [Settings Management](/desktop/hardened-desktop/settings-management/) to set `analyticsEnabled` for all your users. |
67+
| Active users (graph) | The view over time for total active users. |
6668

6769

6870
### Builds

content/manuals/admin/organization/manage-a-team.md

Lines changed: 34 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -10,37 +10,36 @@ aliases:
1010

1111
You can create teams for your organization in Docker Hub and the Docker Admin Console. You can [configure repository access for a team](#configure-repository-permissions-for-a-team) in Docker Hub.
1212

13-
A team is a group of Docker users that belong to an organization. An
14-
organization can have multiple teams. An
15-
organization owner can then create new teams and add members to an existing team
16-
using their Docker ID or email address and by selecting a team the user should be part of. Members aren't required to be part of a team to be associated with an organization.
13+
A team is a group of Docker users that belong to an organization. An organization can have multiple teams. An organization owner can then create new teams and add members to an existing team using their Docker ID or email address and by selecting a team the user should be part of. Members aren't required to be part of a team to be associated with an organization.
1714

1815
The organization owner can add additional organization owners to help them manage users, teams, and repositories in the organization by assigning them the owner role.
1916

2017
## Organization owner
2118

22-
An organization owner is an administrator who is responsible to manage
23-
repositories and add team members to the organization. They have full access to
24-
private repositories, all teams, billing information, and org settings. An org
25-
owner can also specify [permissions](#permissions-reference) for each team in
26-
the organization. Only an org owner can enable [SSO](../../security/for-admins/single-sign-on/_index.md)
27-
for
28-
the organization. When SSO is enabled for your organization, the org owner can
19+
An organization owner is an administrator who has the following permissions:
20+
21+
- Manage repositories and add team members to the organization.
22+
- Access private repositories, all teams, billing information, and organization settings.
23+
- Specify [permissions](#permissions-reference) for each team in the organization.
24+
- Enable [SSO](../../security/for-admins/single-sign-on/_index.md) for the organization.
25+
26+
When SSO is enabled for your organization, the organization owner can
2927
also manage users. Docker can auto-provision Docker IDs for new end-users or
3028
users who'd like to have a separate Docker ID for company use through SSO
3129
enforcement.
3230

33-
The org owner can also add additional org owners to help them manage users, teams, and repositories in the organization.
31+
The organization owner can also add additional organization owners to help them manage users, teams, and repositories in the organization.
3432

3533
## Create a team
3634

3735
{{< tabs >}}
3836
{{< tab name="Docker Hub" >}}
3937

40-
1. Go to **Organizations** in Docker Hub, and select your organization.
41-
2. Select the **Teams** tab and then select **Create Team**.
42-
3. Fill out your team's information and select **Create**.
43-
4. [Add members to your team](members.md#add-a-member-to-a-team).
38+
1. Sign in to [Docker Hub](https://hub.docker.com).
39+
2. Select **Organizations** and choose your organization.
40+
3. Select the **Teams** tab and then select **Create Team**.
41+
4. Fill out your team's information and select **Create**.
42+
5. [Add members to your team](members.md#add-a-member-to-a-team).
4443

4544
{{< /tab >}}
4645
{{< tab name="Admin Console" >}}
@@ -61,19 +60,18 @@ The org owner can also add additional org owners to help them manage users, team
6160
Organization owners can configure repository permissions on a per-team basis.
6261
For example, you can specify that all teams within an organization have "Read and
6362
Write" access to repositories A and B, whereas only specific teams have "Admin"
64-
access. Note that org owners have full administrative access to all repositories within the organization.
63+
access. Note that organization owners have full administrative access to all repositories within the organization.
6564

66-
To give a team access to a repository
65+
To give a team access to a repository:
6766

68-
1. Navigate to **Organizations** in Docker Hub, and select your organization.
69-
2. Select the **Teams** tab and select the team that you'd like to configure repository access to.
70-
3. Select the **Permissions** tab and select a repository from the
67+
1. Sign in to [Docker Hub](https://hub.docker.com).
68+
2. Select **Organizations** and choose your organization.
69+
3. Select the **Teams** tab and select the team that you'd like to configure repository access to.
70+
4. Select the **Permissions** tab and select a repository from the
7171
**Repository** drop-down.
72-
4. Choose a permission from the **Permissions** drop-down list and select
72+
5. Choose a permission from the **Permissions** drop-down list and select
7373
**Add**.
7474

75-
![Team Repo Permissions](../images/team-repo-permission.png)
76-
7775
Organization owners can also assign members the editor role to grant partial administrative access. See [Roles and permissions](../../security/for-admins/roles-and-permissions.md) for more about the editor role.
7876

7977
### Permissions reference
@@ -110,8 +108,10 @@ you automatically have "Read-only" permissions:
110108

111109
To view a team's permissions across all repositories:
112110

113-
1. Open **Organizations** > **_Your Organization_** > **Teams** > **_Team Name_**.
114-
2. Select the **Permissions** tab, where you can view the repositories this team can access.
111+
1. Sign in to [Docker Hub](https://hub.docker.com).
112+
2. Select **Organizations** and choose your organization.
113+
3. Select **Teams** and choose your team name.
114+
4. Select the **Permissions** tab, where you can view the repositories this team can access.
115115

116116
## Delete a team
117117

@@ -120,19 +120,20 @@ Organization owners can delete a team in Docker Hub or Admin Console. When you r
120120
{{< tabs >}}
121121
{{< tab name="Docker Hub" >}}
122122

123-
1. Go to **Organizations** in Docker Hub, and select your organization.
124-
2. Select the **Teams** tab.
125-
3. Select the name of the team that you want to delete.
126-
4. Select **Settings**.
127-
5. Select **Delete Team**.
128-
6. Review the confirmation message, then select **Delete**.
123+
1. Sign in to [Docker Hub](https://hub.docker.com).
124+
2. Select **Organizations** and choose your organization.
125+
3. Select the **Teams** tab.
126+
4. Select the name of the team that you want to delete.
127+
5. Select **Settings**.
128+
6. Select **Delete Team**.
129+
7. Review the confirmation message, then select **Delete**.
129130

130131
{{< /tab >}}
131132
{{< tab name="Admin Console" >}}
132133

133134
{{< include "admin-early-access.md" >}}
134135

135-
1. In Admin Console, select your organization.
136+
1. In the [Admin Console](https://app.docker.com/admin), select your organization.
136137
2. In the **User management** section, select **Teams**.
137138
3. Select the **Actions** icon next to the name of the team you want to delete.
138139
4. Select **Delete team**.

content/manuals/admin/organization/members.md

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -205,7 +205,25 @@ Owners can export a CSV file containing all members. The CSV file for a company
205205
- Invited to Organizations: All organizations the user is an invitee of within a company
206206
- Account Created: The time and date when the user account was created
207207

208-
To export a CSV file of the members:
208+
{{< tabs >}}
209+
{{< tab name="Docker Hub" >}}
210+
211+
To export a CSV file of your members:
212+
209213
1. Sign in to [Docker Hub](https://hub.docker.com).
210214
2. Select **Organizations**, your organization, and then **Members**.
211-
3. Select the **Action** icon and then select **Export users as CSV**.
215+
3. Select the **Action** icon and then select **Export users as CSV**.
216+
217+
{{< /tab >}}
218+
{{< tab name="Admin Console" >}}
219+
220+
{{< include "admin-early-access.md" >}}
221+
222+
To export a CSV file of your members:
223+
224+
1. In the [Admin Console](https://app.docker.com/admin), select your organization.
225+
2. Select **Members**.
226+
3. Select the **download** icon to export a CSV file of all members.
227+
228+
{{< /tab >}}
229+
{{< /tabs >}}

0 commit comments

Comments
 (0)