first commit

core/modules/user/help_topics/user.create.html.twig

@@ -0,0 +1,21 @@
+---
+label: 'Creating a user account'
+related:
+  - user.security_account_settings
+  - user.overview
+---
+{% set people_link_text %}{% trans %}People{% endtrans %}{% endset %}
+{% set people_link = render_var(help_route_link(people_link_text, 'entity.user.collection')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Create a new user account.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>{{ people_link }}</em>.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Add user</em>.{% endtrans %}</li>
+  <li>{% trans %}Enter the <em>Email address</em>, <em>Username</em>, and <em>Password</em> (twice) for the new user.{% endtrans %}</li>
+  <li>{% trans %}Verify that the <em>Roles</em> checked for the new user are correct.{% endtrans %}</li>
+  <li>{% trans %}If you want the new user to receive an email message notifying them of the new account, check <em>Notify user of new account</em>.{% endtrans %}</li>
+  <li>{% trans %}Optionally, change other settings on the form.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Create new account</em>.{% endtrans %}</li>
+  <li>{% trans %}You will be left on the <em>Add user</em> page; repeat these steps if you have more user accounts to create.{% endtrans %}</li>
+</ol>

core/modules/user/help_topics/user.new_role.html.twig

@@ -0,0 +1,17 @@
+---
+label: 'Adding a new role'
+related:
+  - user.overview
+  - user.permissions
+---
+{% set roles_link_text %}{% trans %}Roles{% endtrans %}{% endset %}
+{% set roles_link = render_var(help_route_link(roles_link_text, 'entity.user_role.collection')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Create a new role.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>People</em> &gt; <em>{{ roles_link }}</em>.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Add role</em>.{% endtrans %}</li>
+  <li>{% trans %}Enter the desired <em>Role name</em>. If desired, click <em>Edit</em> to change the <em>Machine name</em> for the role.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Save</em>. You should be returned to the <em>Roles</em> page and your new role should be in the role list.{% endtrans %}</li>
+</ol>

core/modules/user/help_topics/user.overview.html.twig

@@ -0,0 +1,12 @@
+---
+label: 'Managing user accounts and site visitors'
+top_level: true
+---
+<h2>{% trans %}What is a user?{% endtrans %}</h2>
+<p>{% trans %}A user is anyone accessing or viewing your site. <em>Anonymous</em> users are users who are not logged in, and <em>Authenticated</em> users are users who are logged in.{% endtrans %}</p>
+<h2>{% trans %}What is a role?{% endtrans %}</h2>
+<p>{% trans %}<em>Roles</em> are used to group and classify users; each user can be assigned one or more roles. There are also special roles for all anonymous and all authenticated users.{% endtrans %}</p>
+<h2>{% trans %}What is a permission?{% endtrans %}</h2>
+<p>{% trans %}Granting a <em>permission</em> to a role allows users who have been assigned that role to perform an action on the site, such as viewing content, editing or creating  a particular type of content, administering settings for a particular module, or using a particular function of the site (such as search).{% endtrans %}</p>
+<h2>{% trans %}Overview of managing user accounts and visitors{% endtrans %}</h2>
+<p>{% trans %}The core User module allows users to register, log in, and log out, and administrators to manage user roles and permissions. The core Ban module allows administrators to ban certain IP addresses from accessing the site. Depending on which modules you have installed on your site, the related topics below will help you with tasks related to managing user accounts and visitors.{% endtrans %}</p>

core/modules/user/help_topics/user.permissions.html.twig

@@ -0,0 +1,17 @@
+---
+label: 'Modifying the permissions for a role'
+related:
+  - user.overview
+  - user.new_role
+  - core.security
+---
+{% set permissions_link_text %}{% trans %}Permissions{% endtrans %}{% endset %}
+{% set permissions_link = render_var(help_route_link(permissions_link_text, 'user.admin_permissions')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Modify the permissions for an existing role.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>People</em> &gt; <em>{{ permissions_link }}</em>.{% endtrans %}</li>
+  <li>{% trans %}Review the permissions for the role, paying particular attention to the permissions marked with <em>Warning: Give to trusted roles only; this permission has security implications.</em> Uncheck permissions that this role should not have, in the row of the permission and the column of the role; check permissions that this role should have.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Save permissions</em>.{% endtrans %}</li>
+</ol>

core/modules/user/help_topics/user.security_account_settings.html.twig

@@ -0,0 +1,36 @@
+---
+label: 'Configuring how user accounts are created and deleted'
+related:
+  - core.security
+  - user.overview
+---
+{% set account_settings_link_text %}{% trans %}Account settings{% endtrans %}{% endset %}
+{% set account_settings_link = render_var(help_route_link(account_settings_link_text, 'entity.user.admin_form')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Configure settings related to how user accounts are created and deleted.{% endtrans %}</p>
+<h2>{% trans %}What are the settings related to user account creation and deletion?{% endtrans %}</h2>
+<ul>
+  <li>{% trans %}You can make it possible for new users to register themselves for accounts, with or without email verification or administrative approval. Or, you can make it so only administrators with <em>Administer users</em> permission can register new users.{% endtrans %}</li>
+  <li>{% trans %}You can configure what happens to content that a user created, if their account is <em>canceled</em> (deleted).{% endtrans %}</li>
+  <li>{% trans %}You can edit the email messages that are sent to users when their accounts are pending, approved, created, blocked, or canceled, or when they request a password reset.{% endtrans %}</li>
+</ul>
+<h2>{% trans %}What are variables in email message text?{% endtrans %}</h2>
+<p>{% trans %}<em>Variables</em> are short text strings, enclosed in square brackets [], that you can insert into configured email message text. When an individual message is generated, data from your site is substituted for the variables. Some commonly-used variables are:{% endtrans %}</p>
+<ul>
+  <li>{% trans %}[site:name]: The name of your website.{% endtrans %}</li>
+  <li>{% trans %}[site:url]: The URL of your website.{% endtrans %}</li>
+  <li>{% trans %}[site:login-url]: The URL where users can log in to your site.{% endtrans %}</li>
+  <li>{% trans %}[user:display-name]: The user's displayed name.{% endtrans %}</li>
+  <li>{% trans %}[user:account-name]: The user's account name.{% endtrans %}</li>
+  <li>{% trans %}[user:mail]: The user's email alias.{% endtrans %}</li>
+  <li>{% trans %}[user:one-time-login-url]: An expiring URL that a user can use to log in once, if they need to reset their password.{% endtrans %}</li>
+</ul>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>People</em> &gt; <em>{{ account_settings_link }}</em>.{% endtrans %}</li>
+  <li>{% trans %}Select the method you want to use for creating user accounts, and check or uncheck the box that requires email verification, to match the settings you want for your site.{% endtrans %}</li>
+  <li>{% trans %}Select the desired option for what happens to content that a user created if their account is canceled.{% endtrans %}</li>
+  <li>{% trans %}Optionally, edit the text of email messages related to user accounts.{% endtrans %}</li>
+  <li>{% trans %}Verify that the other settings are correct.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Save configuration</em>. You should see a message indicating that the settings were saved.{% endtrans %}</li>
+</ol>

core/modules/user/help_topics/user.update.html.twig

@@ -0,0 +1,18 @@
+---
+label: 'Modifying or deleting a user account'
+related:
+  - user.security_account_settings
+  - user.overview
+---
+{% set people_link_text %}{% trans %}People{% endtrans %}{% endset %}
+{% set people_link = render_var(help_route_link(people_link_text, 'entity.user.collection')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Update or delete an existing user account.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>{{ people_link }}</em>.{% endtrans %}</li>
+  <li>{% trans %}Enter all or part of the user name or email address of the user account you want to update or delete, and click <em>Filter</em>. A short list of user accounts, including the account of interest, should be shown in the table; if not, modify the filter text until you can find the account of interest.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Edit</em> in the <em>Operations</em> area of the account of interest.{% endtrans %}</li>
+  <li>{% trans %}To delete the user account, scroll to the bottom and click <em>Cancel account</em>. Select what you want to happen to the user's content on the next screen, and click <em>Cancel account</em>.{% endtrans %}</li>
+  <li>{% trans %}To update the user account, enter new values in the form and click <em>Save</em>.{% endtrans %}</li>
+</ol>