Rename from review suggestions

docs/user/migrating_from_35_client.md → docs/user/migrate_36_cli.md

@@ -2,9 +2,8 @@
 title: Migrating from pre-36.0.0 Clients
 ---
 
-In Rucio 36.0.0, a new rucio client was released. 
-This new client redos the entire structure of both `rucio` and `rucio-admin`. 
-`rucio-admin` is made redundant by the update, their commands are included in the `rucio >=36.0` client. 
+In Rucio 36.0.0, a new Rucio client was released, with breaking changes to the structure of both `rucio` and `rucio-admin`.
+`rucio-admin` is made redundant by the update, and its commands are included in the `rucio >=36.0` client.
 
 Note: 
     Please report any issues you have with the new client [on this github issue](https://github.com/rucio/rucio/issues/7224)
@@ -13,8 +12,8 @@ Note:
 
 * Using `rucio-admin` or `rucio --legacy` automatically uses the old version. Old help menus are still visible with this method. 
 * Old commands still work - they display a warning.
-* Not all commands are included in the 36 Client Release. Not all are one-to-one mapped. 
-* A warning it printed (not logged) to consoles to encourage migration, along with the closest mapped command. 
+* Not all commands are migrated to the new client structure. Not all included commands are one-to-one mapped.
+* A warning is printed (not logged) to consoles to encourage migration, along with the closest mapped command. 
 
 
 # Remapping Existing Commands
@@ -48,7 +47,7 @@ Note:
 | rucio list-account-limits | rucio account limit list |
 | rucio add-rule | rucio rule add |
 | rucio delete-rule | rucio rule remove |
-| rucio rule-info | rucio rule info |
+| rucio rule-info | rucio rule show |
 | rucio list-rules | rucio rule list |
 | rucio list-rules-history | rucio rule history |
 | rucio update-rule | rucio rule update |

docs/user/using_the_client.md

@@ -6,8 +6,7 @@ title: Using the Client
 Rucio provides several commands for the end-user. See [executables](bin/rucio.md).
 The command line client is called ``rucio``.
 
-Please note that these commands are not meant to be included in python scripts. 
-For such applications, we encourage using the [python client](pathname:///html/site/client.html). 
+Note: for Python scripts, we encourage using the [Python client](pathname:///html/site/client.html) instead of the commands listed here.
 
 If you are using a version of the client prior to ~36.0, please view the [migration guide](user/migrating_from_35_client.md).
 
@@ -442,7 +441,7 @@ You can set attributes to the users:
 And list these attributes:
 
 ```bash
-  $ rucio-admin account attribute list --account jdoe
+  $ rucio account attribute list --account jdoe
   +---------+-------+
   | Key     | Value |
   |---------+-------|

website/sidebars.json

@@ -32,7 +32,7 @@
                 "user/configuring_the_client",
                 "user/using_the_client",
                 "user/developing_with_rucio",
-                "user/migrating_from_35_client"
+                "user/migrate_36_cli"
             ],
             "Operator": [
                 "operator/setting_up_demo",