diff --git a/docs/tools/aiven-console/howto/create-accounts.rst b/docs/tools/aiven-console/howto/create-accounts.rst index a85df88548..b7b92a38c3 100644 --- a/docs/tools/aiven-console/howto/create-accounts.rst +++ b/docs/tools/aiven-console/howto/create-accounts.rst @@ -1,12 +1,12 @@ Create organizations and organizational units ============================================== -**Organizations** and **organizational units** (or **units**) can be used to group projects and apply common settings like authentication and access for groups of users. For details and recommendations on creating hierarchical organizations in Aiven, see :doc:`Organizations, projects, and managing access permissions `. +Organizations and organizational units can be used to group projects and apply common settings like authentication and access for groups of users. For details and recommendations on creating hierarchical organizations in Aiven, see the article on :doc:`organizations, units, and projects `. When you sign up for Aiven, an organization is automatically created for you. Create an organizational unit ---------------------------------- +------------------------------ -You can create an organizational unit within an organization to group your projects by things like your departments or environments. To create an organizational unit: +You can create an organizational unit within an organization to group your projects by, for example, your departments or environments. To create an organizational unit in the `Aiven Console `_: #. In the organization where you want to create an organizational unit, click **Admin**. @@ -14,40 +14,34 @@ You can create an organizational unit within an organization to group your proje #. Enter a name for the unit. -#. Select any projects that you want to assign to this organizational unit. You can search for projects by name. - -#. If you want to invite admin users to the unit, set the toggle to **Yes** and enter their email addresses. They will receive an email invitation with a confirmation link. - - .. important:: Admin have full control over the organizational unit and the projects assigned to it. +#. Optional: Select any projects that you want to assign to this organizational unit. You can search for projects by name. #. Click **Create organizational unit**. -Your organizational unit is shown in the **Organizational units** section. Click the unit name to view and manage it's groups and projects. +Your organizational unit is shown in the list. Click the unit name to view and manage its projects. .. note:: Only one level of nesting is supported. This means that organizational units cannot be created within other units. Create an organization --------------------------- +----------------------- .. important:: - We recommend using **only one organization** and creating organizational units to group your projects. + We recommend using only one organization and using organizational units to group your projects. Creating a new organization requires you to manually configure organization-level settings again such as :doc:`billing groups, authentication settings, and groups `. -#. Click the user information icon and select **Organizations**. +To create an organization in the `Aiven Console `_: -#. On the **Organizations** tab of the **User profile**, click **Create organization**. +#. Click the user information icon in the top right and select **Organizations**. -#. Enter a name for the organization. +#. Click **Create organization**. -#. Select any projects that you want to assign to this organization. You can search for projects by name. +#. Select the checkbox to confirm that you understand the effects of creating an organization. -#. If you want to invite admin users to the organization, set the toggle to **Yes** and enter their email addresses. They will receive an email invitation with a confirmation link. +#. Enter a name for the organization. - .. important:: Admin users have full control over the organization and the projects assigned to it after they accept the invitation,. +#. Optional: Select any projects that you want to assign to this organization. You can search for projects by name. #. Click **Create organization**. - -The **Admin** page opens, where you can add organizational units, and manage groups, projects, and other settings. \ No newline at end of file