Implement review comments

Author: dabrt

docs/users/invitations.md

@@ -2,24 +2,25 @@
 description: Manage user invitations to create an account in the frontend or the Back Office.
 ---
 
-# Invite users
+# Inviting users
 
 [[= product_name =]] allows you to create and send invitations to create an account in
-the frontend as a customer, the Back Office as an employee, or the Corporate Portal as an organization member.
+the frontend as a customer, the Back Office as an employee, or the Corporate Portal as an organisation member.
 You can send invitations to individual users or in bulk.
 
 ## Roles and Policies
 
 To invite other members to the site or the Back Office, a user needs to have the `User:Invite` permission added to their Role.
-You can limit the ability to invite other members to specific user groups, such as Editors, or to the specific Roles within the group, for example: Admin, Buyer.
+You can limit the ability to invite other members to specific User Groups, 
+such as Editors, or to the specific Roles within the group, for example: Admin, Buyer.
 
 ## Creating and sending invitations
 
 Invitations are created with [InvitationService](../api/php_api/php_api_reference/classes/Ibexa-Contracts-User-Invitation-InvitationService.html),
 but sending them requires additional setup.
 [[= product_name =]] provides you with `Ibexa\User\Invitation\MailSender` implementation of
 `InvitationSender` interface for sending invitations via email.
-If you want to send invitations through different channels, you need to create a custom setup.
+If you want to send invitations through different channels, you will need to create a custom setup.
 
 ## Invitation and registration form templates
 
@@ -28,7 +29,7 @@ If you want to send invitations through different channels, you need to create a
 To set up custom templates for invitation or registration forms,
 create a template file and inform the system, through configuration, when to use this template.
 
-You might also set a SiteAccess under `scope`, to which the new user is invited.
+You might also set a SiteAccess under `scope`, to which the new user will be invited.
 If the SiteAccess is not set, it falls back to the default `site` value.
 
 For example, use the following [configuration](configuration.md#configuration-files):

docs/users/update_basic_user_data.md

@@ -5,46 +5,48 @@ description: Update basic user account data from the console.
 # Update basic user data from CLI
 
 Multiple user management scenarios may result in having to update basic user account data, such as user status, the password, or email.
-Especially, when a security breach occurs, you may need to revoke user access by disabling the account, or change the user's password.
+Especially, you may need to revoke user access by disabling the account when offboarding an employee, or change the user's forgotten password.
 
 You can do it without accessing the Admin UI, by running a console command.
-You reference the user account with either user id or login.
+You reference the user account by passing the user login.
 
 ## Disable or enable user account
 
-To change the status of a user account, you must have the `user/activation` permission.
-
 Disable the user account:
 
 ```bash
-php bin/console ibexa:user:update-user --disable <user_reference>
+php bin/console ibexa:user:update-user --disable <login>
+```
+
+For example:
+
+```bash
+php bin/console ibexa:user:update-user --disable johndoe
 ```
 
 Enable the user account:
 
 ```bash
-php bin/console ibexa:user:update-user --enable <user_reference>
+php bin/console ibexa:user:update-user --enable <login>
 ```
 
 ## Change password
 
-To change the password, you must have the `user/password` permission.
-
 Change the password associated with the user account:
 
 ```bash
-php bin/console ibexa:user:update-user --password <user_reference>
+php bin/console ibexa:user:update-user --password <login>
 ```
 
 After you run the command, enter the new password when prompted.
 The command runs in silent mode and inputs are not echoed.
 
-For more information about changing and revoking passwords, see [Passwords](passwords.md#revoking-passwords).
+For more information about changing and revoking passwords, for example, when a security breach occurs, see [Passwords](passwords.md#revoking-passwords).
 
 ## Change email address
 
 Change the email address associated with the user account:
 
 ```bash
-php bin/console ibexa:user:update-user --email=<new_email_address> <user_reference>
+php bin/console ibexa:user:update-user --email=<new_email_address> <login>
 ```