From 4c041f772d63947df6259c151b89f2c4e1623aeb Mon Sep 17 00:00:00 2001
From: Will Vedder <will.vedder@okta.com>
Date: Fri, 14 Apr 2023 09:44:03 -0400
Subject: [PATCH] Updating changelog and migration guide to include changes
 from #738

---
 CHANGELOG.md       |  2 ++
 MIGRATION_GUIDE.md | 33 ++++++++-------------------------
 2 files changed, 10 insertions(+), 25 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9edd9dfcb..f910b106f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -73,6 +73,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `--reveal` flag for reveal client secret renamed to `--reveal-secrets` [#591]
 - More actionable output when executing `auth0 users import` [#735]
 - Editorializing code "hints" throughout project [#570]
+- Renamed `--connection` flag to `--connection-name` for `auth0 users` commands for consistency [#738]
 
 ### Removed
 
@@ -170,6 +171,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 [unreleased]: https://github.com/auth0/auth0-cli/compare/v1.0.0...HEAD
 [#733]: https://github.com/auth0/auth0-cli/issues/733
+[#738]: https://github.com/auth0/auth0-cli/issues/738
 [#735]: https://github.com/auth0/auth0-cli/issues/735
 [#736]: https://github.com/auth0/auth0-cli/issues/736
 [#694]: https://github.com/auth0/auth0-cli/issues/694
diff --git a/MIGRATION_GUIDE.md b/MIGRATION_GUIDE.md
index c91d0703a..d497a1678 100644
--- a/MIGRATION_GUIDE.md
+++ b/MIGRATION_GUIDE.md
@@ -167,31 +167,14 @@ auth0 login --domain travel0.us.auth0.com \
 </tr>
 </table>
 
-#### Users Import Command
+#### Users Commands
 
-The `-u` short form alias for the `--upsert` flag in the `auth0 users import` command has been redesignated to the `--users` flag which will likely see more prominent usage.
+The `--connection` flag has been renamed to `--connection-name` for the `auth0 users update`, `auth0 users create` and `auth0 users import` commands for consistency.
 
-<table>
-<tr>
-<th>Before (v0)</th>
-<th>After (v1)</th>
-</tr>
-<tr>
-<td>
-
-```sh
-# Example:
-auth0 users import -u
-```
+Also notably for the `auth0 users import` command, the `-u` short form alias for the `--upsert` flag in the command has been redesignated to the `--users` flag.
 
-</td>
-<td>
-
-```sh
-# Example:
-auth0 users import --upsert
-```
-
-</td>
-</tr>
-</table>
+| **Before (v0)**                      | **After (v1)**                                  |
+| ------------------------------------ | ----------------------------------------------- |
+| `auth0 users create --connection`    | `auth0 users create --connection-name`          |
+| `auth0 users update --connection`    | `auth0 users update --connection-name`          |
+| `auth0 users import -u --connection` | `auth0 users import --upsert --connection-name` |