2. Run `asciidoctor` on the `index.adoc` file in the repo's root:  

     ```

     ```

  3. Open the resulting HTML file in a browser of your choice:  

  = Adding a New User Account

  This section describes how you can add a new user account so that another person can use the system as a regular user.

  include::procedure-useradd.adoc[leveloffset=+1]

  == Additional Resources

  = Adjusting File Permissions

  This section describes how you can adjust permissions for a file or directory so that a specific user or user group can read, write, or execute the file or directory.

  = Changing Default MariaDB Database Location

  This section describes how you can change the default location for MariaDB.

  = Configuring Password Policies

  This section describes how to configure a password policy for a user.

  .Prerequisites

  include::procedure-setting_passwords.adoc[leveloffset=+1]

  = Creating Group Directories

  // Ideally, base the name of the file on the title to avoid confusion

  == Additional Resources

  = Verifying File Permissions

  This section describes how you can verify what the permissions for a directory are file so that you can make sure which user or user group can access which files or directories. You can also verify what files or directories you can access.

  // Include an 'ID' that corresponds to the title of the assembly

  // The ID will be used as an anchor for linking to the title

  // Do not change the ID to make sure existing links keep working

  = Concept Template and Guidelines

  _In the title, include nouns that are used in the body text -- this helps readers and search engines find information quickly._

  // Include an 'ID' that corresponds to the title of the assembly

  // The ID will be used as an anchor for linking to the title

  // Do not change the ID to make sure existing links keep working

  = Concept Template and Guidelines

  _In the title, include nouns that are used in the body text -- this helps readers and search engines find information quickly._

  // locally defined replaceable

  :MAJOROS: Fedora

  = What Is a Group?

  Additionally, {MAJOROS} supports _access control lists_ (*ACLs*) for files and directories which allow permissions for specific users outside of the owner to be set. For more information about this feature, see the link:https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/System_Administrators_Guide/ch-Access_Control_Lists.html[_Access Control Lists_] chapter of the link:https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/System_Administrators_Guide/index.html[_Red Hat Enterprise Linux 7 System Administrators Guide_].

  = What Is a User?

  Users can be either people (meaning accounts tied to physical users) or accounts which exist for specific applications to use.

  = Adding Users to User Groups

  This procedure describes how to add a user to a user group with the `usermod` command.

  . Add users to the your new user group:

  +

  ----

  usermod -aG myproject _username_

  ----

  // Include an 'ID' that corresponds to the title of the assembly

  // The ID will be used as an anchor for linking to the title

  // Do not change the ID to make sure existing links keep working

  = Doing One Procedure

  _Start the title with a verb form, such as Creating or Create._

  = Using `chown` and `chmod` on a Directory for a User Group

  This procedure describes how to ensure that all members of a group can create and edit files in a directory.

  = Creating a Directory

  The `mkdir` command creates a directory.

  = Creating a User Group

  This procedure describes how to create a group with the `groupadd` command.

  . Create the `myproject` group by typing the following at a shell prompt as `root`:

  +

  ----

  groupadd _options_ myproject

  ----

  = Enabling Password Aging

  For security reasons, it is advisable to require users to change their passwords periodically. This can be done using the [command]`chage` command.

  // Include an 'ID' that corresponds to the title of the assembly

  // The ID will be used as an anchor for linking to the title

  // Do not change the ID to make sure existing links keep working

  = Doing One Procedure

  _Start the title with a verb form, such as Creating or Create._

  // Include an 'ID' that corresponds to the title of the assembly

  // The ID will be used as an anchor for linking to the title

  // Do not change the ID to make sure existing links keep working

  = Doing One Procedure

  _Start the title with a verb form, such as Creating or Create._

  = Setting Passwords

  For security reasons, it is advisable to require users to change their passwords periodically.

  // Include an 'ID' that corresponds to the title of the assembly

  // The ID will be used as an anchor for linking to the title

  // Do not change the ID to make sure existing links keep working

  = Adding a New User

  This procedure describes how to create a new user with the `useradd` command.

  // Include an 'ID' that corresponds to the title of the assembly

  // The ID will be used as an anchor for linking to the title

  // Do not change the ID to make sure existing links keep working

  = Doing One Procedure

  _Start the title with a verb form, such as Creating or Create._

  = chage Command-line Options

  When the [command]`chage` command is followed directly by a username (that is, when no command-line options are specified), it displays the specified user's current password-aging values and allows you to change these values interactively.

  [options="header",cols="1,8"]

  |===

  |Option|Description

  [options="header"]

  |===

  |Option|Description

  // Include an 'ID' that corresponds to the title of the assembly

  // The ID will be used as an anchor for linking to the title

  // Do not change the ID to make sure existing links keep working

  = Reference Template and Guidelines

  _In the title, include nouns that are used in the body text — this helps readers and search engines find information quickly._

  [[table-useradd-options]]

  .Common `useradd` command-line options

  [#sysadmin_user_stories]

  = SysAdmin User Stories