updated user create and delete docs, resolves #687

content/v2.0/reference/cli/influx/user/create.md

@@ -16,11 +16,12 @@ influx user create [flags]
 ```
 
 ## Flags
-| Flag               | Description                                                                      | Input type  |
-|:----               |:-----------                                                                      |:----------: |
-| `-h`, `--help`     | Help for `create`                                                                |             |
-| `-n`, `--name`     | The user name **(Required)**                                                     | string      |
-| `-o`, `--org-id`   | The organization ID to add the user to<br/> _(Required if password is provided)_ | string      |
-| `-p`, `--password` | The user password                                                                | string      |
+| Flag               | Description                                     | Input type  |
+|:----               |:-----------                                     |:----------: |
+| `-h`, `--help`     | Help for `create`                               |             |
+| `-n`, `--name`     | The username **(Required)**                     | string      |
+| `-o`, `--org`      | The name of the organization to add the user to | string      |
+| `--org-id`         | The ID fo the organization to add the user to   | string      |
+| `-p`, `--password` | The user password                               | string      |
 
 {{% influx-cli-global-flags %}}

content/v2.0/reference/cli/influx/user/find.md

@@ -20,6 +20,6 @@ influx user find [flags]
 |:----           |:-----------     |:----------: |
 | `-h`, `--help` | Help for `find` |             |
 | `-i`, `--id`   | The user ID     | string      |
-| `-n`, `--name` | The user name   | string      |
+| `-n`, `--name` | The username    | string      |
 
 {{% influx-cli-global-flags %}}

content/v2.0/reference/cli/influx/user/update.md

@@ -21,6 +21,6 @@ influx user update [flags]
 |:----           |:-----------                |:----------: |
 | `-h`, `--help` | Help for `update`          |             |
 | `-i`, `--id`   | The user ID **(Required)** | string      |
-| `-n`, `--name` | The user name              | string      |
+| `-n`, `--name` | The username               | string      |
 
 {{% influx-cli-global-flags %}}

content/v2.0/users/create-user.md

@@ -15,7 +15,7 @@ to create a user.
 ## Create a user in the InfluxDB UI
 
 {{% note %}}
-While in alpha, additional users cannot be created in the InfluxDB UI.
+Currently, additional users cannot be created in the InfluxDB UI.
 {{% /note %}}
 
 ## Create a user using the influx CLI
@@ -24,26 +24,30 @@ Use the [`influx user create` command](/v2.0/reference/cli/influx/user/create)
 to create a new user. A new user requires the following:
 
 - A username
+- The organization name or organization ID to add the user to _(provided in the output of
+  [`influx org find`](/v2.0/reference/cli/influx/org/find/))_
 
 ```sh
 # Pattern
-influx user create -n <username>
+influx user create -n <username> -o <org-name>
 
 # Example
-influx user create -n johndoe
+influx user create -n johndoe -o example-org
 ```
 
 ### Create a user with a password and organization
 To create a new user with a password and add the user as a member of an organization,
 include a password and organization ID with the `influx user create` command.
 
-_Use the [`influx org find` command](/v2.0/reference/cli/influx/org/find/)
-to retrieve your organization ID._
+- A username
+- The organization name or organization ID to add the user to _(provided in the output of
+  [`influx org find`](/v2.0/reference/cli/influx/org/find/))_
+- A password
 
 ```sh
 # Pattern
-influx user create -n <username> -p <password> -o <org-id>
+influx user create -n <username> -p <password> -o <org-name>
 
 # Example
-influx user create -n johndoe -p PaSsWoRd -o 0o0x00o0x0000oo0
+influx user create -n johndoe -p PaSsWoRd -o example-org
 ```

content/v2.0/users/delete-user.md

@@ -10,12 +10,18 @@ weight: 103
 ---
 
 Use the InfluxDB user interface (UI) or the `influx` command line interface (CLI)
-to create a user.
+to delete a user.
+
+{{% warn %}}
+Deleting a user removes them completely from InfluxDB.
+To remove a user from an organization without deleting the user entirely, see
+[Remove a member from an organization](/v2.0/org/members/remove/).
+{{% /warn %}}
 
 ## Delete a user from the InfluxDB UI
 
 {{% note %}}
-While in alpha, users cannot be deleted from the InfluxDB UI.
+Currently, users cannot be deleted from the InfluxDB UI.
 {{% /note %}}
 
 ## Delete a user using the influx CLI