Skip to content

Commit a533ec8

Browse files
committed
inverted pyramid
1 parent 4e0b471 commit a533ec8

File tree

1 file changed

+24
-29
lines changed

1 file changed

+24
-29
lines changed

content/manuals/admin/_index.md

Lines changed: 24 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -42,47 +42,42 @@ Administrators start with the [Docker Admin Console](https://app.docker.com/admi
4242
Administrators get started with Docker by accessing the Admin Console to create a company and organizations.
4343

4444
- If you're a Docker Business subscriber, you have access to both company and organization features.
45-
- If you're Docker Team subscriber, you have access to organization features in Admin Console.
46-
47-
As an administrator, you're an owner who can invite users with their email addresses, then assign them member roles to particular teams.
45+
- If you're Docker Team subscriber, you have access to organization features.
4846

4947
## Company and organization hierarchy
5048

51-
Admin Console gives administrators a bird's eye overview of a company and its downstream organizations. Company and organizations have a hierarchical relationship:
49+
Admin Console gives administrators a bird's eye view of who has access to Docker. There are two levels of visibility, company and organizations, and they have a hierarchical relationship:
5250

5351
![Diagram showing Docker’s administration hierarchy with Company at the top, followed by Organizations, Teams, and Members](./images/docker-admin-structure.webp)
5452

55-
Administrators can occupy company owner or organization owner roles (or both), where each role has its own permissions and seat rules.
56-
57-
- Company owners can view and bulk edit settings and configurations for all organizations beneath them.
58-
- Organization owners have full admin permissions to manage settings, members, roles, and teams within their organization, but not organizations they're not part of.
59-
60-
When an administrator creates the first company from Admin Console, they assume owner roles pursuant to their subscription type. For example:
53+
### Company
6154

62-
- A Docker Business subscriber assumes owner permissions for both the first company and first organization.
63-
- A Docker Team subscriber assumes owner permissions for the first created organization.
55+
The highest level of visibility an administrator can have is at the company level. A company owner views and manages all organizations within the company and has full access to company-wide settings.
6456

65-
### Company
57+
### Organization
6658

67-
The highest level of visibility an administrator can have is at the company level. A company owner views and manages all organizations within the company and has full access to company-wide settings.
59+
An organization contains teams and repositories. Organization owners manage organization settings, users, and access controls.
6860

69-
Company owners won't occupy a seat unless one of the following is true:
61+
- All Docker Team and Business
62+
subscribers must create one organization before inviting new members to Docker.
63+
- All organizations owners occupy one seat, but can occupy more than one seat if they're members or owners of multiple, separate organizations.
64+
- Unlike a company, an organization is discrete from other organizations and cannot inherit permissions in bulk from other organizations.
7065

71-
- They are added as a member of an organization under your company.
72-
- SSO is enabled.
66+
If you're a Docker team subscriber who wants access to company-level permissions, you can [upgrade to Docker Business](/subscription/change/#upgrade-your-subscription).
7367

74-
If you're a Docker team subscribe who wants access to company-level permissions, you can [upgrade to Docker Business](/subscription/change/#upgrade-your-subscription).
68+
## Seats and user management
7569

76-
### Organization
70+
The number of seats an administrator can provision depends on their [subscription type](https://www.docker.com/pricing/). Administrators can act as company or organization owners who can invite users with their email addresses, then assign them member roles to particular teams.
7771

78-
An organization contains teams and repositories. All Docker Team and Business
79-
subscribers must create one organization before inviting new members to Docker.
72+
### Company and organization owners
8073

81-
Organization owners manage organization settings, users, and access controls. All organizations owners occupy at least one seat, but can occupy more than one seat if they're members or owners of multiple, separate organizations.
74+
Administrators can occupy company owner or organization owner roles (or both), where each role has its own permissions and seat rules.
8275

83-
## Seats and user management
76+
- Company owners can view and bulk edit settings and configurations for all organizations beneath them.
77+
- Company owners won't occupy a seat unless SSO is enabled, or they're a member of an organization within the company.
78+
- Organization owners have full admin permissions to manage settings, members, roles, and teams within their organization, but not organizations they're not part of.
8479

85-
The number of seats an administrator can provision depends on their [subscription type](https://www.docker.com/pricing/). Once you've decided on a plan and created your first company or organization, you can send invitations to future members.
80+
When an administrator creates the first company or organization from Admin Console, they assume owner roles for the company and/or the organization by default.
8681

8782
### Seats
8883

@@ -91,18 +86,18 @@ A seat is a unit purchased with a subscription plan that extends access to users
9186
- They give administrators granular permissions around who can contribute to a repository.
9287
- They prevent unauthorized users from pushing to a repos they're not members of.
9388

94-
For example, an organization owner takes up one seat. They can invite Docker users to an organization. Once invitees become members, organization owners can set permissions in bulk or on an individual basis to repositories affiliated with an organization.
89+
For example, an organization owner takes up one seat. They can invite Docker users to an organization. Once invitees become members, organization owners can set permissions to members of their company or organization.
9590

9691
### Users and members
9792

98-
Docker uses specific terminology to define the kind of access a Docker user has:
93+
Docker uses specific terminology to define user access:
9994

10095
- A user is someone with a Docker ID.
101-
- They are not necessarily affiliated with an organization.
102-
- They do not take up seats by default.
96+
- They're not necessarily affiliated with an organization.
97+
- They do not occupy a seat by default.
10398
- An invitee is a user invited to an organization.
10499
- Invitees occupy one seat.
105-
- This is a user state before accepting and joining an organization.
100+
- It behaves as a user state before accepting and joining an organization.
106101
- A member is a user who accepted an invitation to an organization.
107102
- Teams let you group members together.
108103
- They are optional.

0 commit comments

Comments
 (0)