Manage users in InfluxDB Clustered (#5555)

* manage clustered users

* added related links to clustered user management

* add back link to clustered manage users

* fixed typos, added links

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <[email protected]>

* remove unnecessary test skip comments

---------

Co-authored-by: Jason Stirnaman <[email protected]>

Author: sanderson

assets/styles/layouts/_syntax-highlighting.scss

@@ -114,6 +114,9 @@ pre[class*="language-"] {
 	.nl, 		/* Name.Label */
 	.si 		/* Literal.String.Interpol */
 					{ color: $article-code-accent4 }
+	
+	.gd     /* Generic.Deleted strike-through*/
+					{ text-decoration: line-through; }
 
 	.m,  		/* Literal.Number */
 	.ni, 		/* Name.Entity */

content/influxdb/clustered/admin/custom-partitions/_index.md

@@ -7,7 +7,7 @@ description: >
 menu:
   influxdb_clustered:
     parent: Administer InfluxDB Clustered
-weight: 103
+weight: 104
 influxdb/clustered/tags: [storage]
 related:
   - /influxdb/clustered/reference/internals/storage-engine/

content/influxdb/clustered/admin/databases/_index.md

@@ -9,7 +9,7 @@ description: >
 menu:
   influxdb_clustered:
     parent: Administer InfluxDB Clustered
-weight: 102
+weight: 103
 influxdb/clustered/tags: [databases]
 ---
 

content/influxdb/clustered/admin/tables/_index.md

@@ -8,7 +8,7 @@ description: >
 menu:
   influxdb_clustered:
     parent: Administer InfluxDB Clustered
-weight: 102
+weight: 103
 influxdb/clustered/tags: [tables]
 ---
 

content/influxdb/clustered/admin/tokens/_index.md

@@ -8,13 +8,13 @@ description: >
 menu:
   influxdb_clustered:
     parent: Administer InfluxDB Clustered
-weight: 102
+weight: 103
 influxdb/clustered/tags: [tokens]
 ---
 
 InfluxDB uses token authentication to authorize access to data in your
 {{< product-name omit=" Clustered" >}} cluster.
-There are two types of tokens:
+With {{< product-name >}}, there are two types of tokens:
 
 - [Database tokens](#database-tokens)
 - [Management tokens](#management-tokens)

content/influxdb/clustered/admin/users/_index.md

@@ -1,18 +1,32 @@
 ---
-title: Manage InfluxDB Clustered users
+title: Manage users in your InfluxDB cluster
 description: >
-  Add or remove users by updating your `myinfluxdb.yml` file and re-applying the configuration.
+  Manage users with administrative access to your InfluxDB cluster through your
+  identity provider and your InfluxDB `AppInstance` resource.
 menu:
   influxdb_clustered:
     name: Manage users
     parent: Administer InfluxDB Clustered
-weight: 101
-draft: true
+weight: 102
+cascade:
+  related:
+    - /influxdb/clustered/install/auth/
+    - /influxdb/clustered/install/configure-cluster/
 ---
 
-To add or remove users, update the users list in the `myinfluxdb.yml` file.
-The users list is found at `spec.package.spec.admin.users`.
-After updating the list, re-apply `myinfluxdb.yml`.
-To learn how to apply `myinfluxdb.yml`, see [Deploy an InfluxDB cluster](/influxdb/clustered/install/deploy).
-After `myinfluxdb.yml` has been applied, updates take a couple of minutes to complete.
-When the updates are finished, new users will have been added, and removed users will have been deleted.
+Manage users with administrative access to your InfluxDB cluster through your
+[identity provider](/influxdb/clustered/install/auth/) and your InfluxDB
+`AppInstance` resource. Administrative access lets users perform actions like
+creating databases and tokens.
+
+{{% note %}}
+#### Users versus database tokens
+
+All _users_ have administrative access to your cluster and can perform
+administrative actions in your InfluxDB cluster.
+_Database tokens_ authorize read and write access to databases in your InfluxDB
+cluster. A person or client doesn't need to be a user to read and write data in your cluster,
+but they must have a database token.
+{{% /note %}}
+
+{{< children >}}