KEYCLOAK-7127 second set of changes from Getting Started review (#378)

* KEYCLOAK-7127 second set of changes from Getting Started review

* cleaned up further and removed unnecessary graphics

getting_started/topics/first-realm.adoc

@@ -1,6 +1,4 @@
 
 == Creating a Realm and User
 
-This short tutorial walks you through creating a new realm within the {project_name} Admin Console and adding
+In this section you will create a new realm within the {project_name} admin console and add a new user to that realm. You will use that new user to log in to your new realm and visit the built-in user account service that all users have access to.
-a new user to that realm. With that new user you will log into your new realm and visit the built-in User Account
-service that all users have access to.

getting_started/topics/first-realm/account.adoc

@@ -1,20 +1,13 @@
 
 === User Account Service
 
-. After creating the user, log out of the management console by clicking the right dropdown menu and selecting *Sign Off*.
+. After you create the new user, log out of the management console by opening the user drop-down menu and selecting *Sign Off*.
 
-. Log in to the User Account Service of your `demo` realm with the user you just created by clicking this link:
+. Go to http://localhost:8080/auth/realms/demo/account and log in to the User Account Service of your `demo` realm with the user you just created.
 
-User Account Link::
+. Type the username and password you created. You will be required create a permanent password after you successfully log in, unless you changed the *Temporary* setting to *Off* when you created the password.
-  http://localhost:8080/auth/realms/demo/account
 
-. Type the username and password you created previously. You must create a permanent password after you successfully log in if you didn't toggle the Temporary switch to *Off* previously.
+The user account service page will open. Every user in a realm has access to this account service by default. From this page, you can update profile information and change or add additional credentials. For more information on this service see the link:{adminguide_link}[{adminguide_name}].
-+
-.Update Password
-image:{project_images}/update-password.png[]
-
-The User Account Service page opens. Every user in a realm has access to this Account Service by default.
-You can update profile information and change or add additional credentials. For more information on this service see the link:{adminguide_link}[{adminguide_name}].
 
 
 

getting_started/topics/first-realm/before.adoc

@@ -1,6 +1,5 @@
 
 === Before You Start
 
-Before you can participate in this tutorial, you need to complete the installation of {project_name} and create the
+Before you can create your first realm, complete the installation of {project_name} and create the initial admin user as shown in <<_install-boot, Installing and Booting>>.
-initial admin user as shown in the <<_install-boot, Installing and Booting>> tutorial.
 

getting_started/topics/first-realm/realm.adoc

@@ -4,24 +4,13 @@
 
 To create a new realm, complete the following steps:
 
-. Log in to the {project_name} Admin Console using the account you created in the
+. Go to http://localhost:8080/auth/admin/ and log in to the {project_name} Admin Console using the account you created in <<_install-boot, Install and Boot>>.
-<<_install-boot, Install and Boot>> tutorial.
 
-Admin Console Link::
+. From the *Master* drop-down menu, click *Add Realm*. When you are logged in to the master realm this drop-down menu lists all existing realms.
-  http://localhost:8080/auth/admin/
 
-. In the top left corner dropdown menu that is titled `Master`, click *Add Realm*.  If you are logged in to the master realm this dropdown menu lists all the realms created. The Add Realm page opens. 
+. Type `demo` in the *Name* field and click *Create*.
-+
-.Add Realm Menu
-image:{project_images}/add-realm-menu.png[]
 
-. You will be creating a brand new realm from scratch so
+When the realm is created, the main admin console page opens. Notice the current realm is now set to `demo`. Switch between managing the `master` realm and the realm you just created by clicking entries in the *Select realm* drop-down menu.
-type `demo` for the realm name and click `Create`.
-+
-.Create Realm
-image:{project_images}/create-realm.png[]
-
-After creating the realm the main Admin Console page opens. The current realm is now set to `demo`. You can switch between managing the `master` realm and the realm you just created by clicking the top left corner dropdown menu.
 
 
 

getting_started/topics/first-realm/user.adoc

@@ -2,31 +2,19 @@
 
 === Creating a New User
 
-To create a new user in the `demo` realm as well as a temporary password for that account, complete the following steps:
+To create a new user in the `demo` realm, along with a temporary password for that new user, complete the following steps:
 
-. In the left menu bar click *Users*. The user list page opens.
+. From the menu, click *Users* to open the user list page.
-+
-.Users
-image:{project_images}/users.png[]
 
-. On the right side of the empty user list, click *Add User*.
+. On the right side of the empty user list, click *Add User* to open the add user page.
 
-+
+. Enter a name in the `Username` field; this is the only required field. Click *Save* to save the data and open the management page for the new user.
-.Add User
-image:{project_images}/add-user.png[]
 
-. The only required field is `Username`.  When you are finished, click *Save*.  The management page for your new user opens.
+. Click the *Credentials* tab to set a temporary password for the new user.
 
-. The next step is to define a temporary password for your new user. Click the *Credentials* tab.
+. Type a new password and confirm it. Click *Reset Password* to set the user password to the new one you specified.  
-+
-.Set Temporary Password
-image:{project_images}/credentials.png[]
 
-. Type a new password and confirm it. A red *Reset Password* button is displayed.
+NOTE: This password is temporary and the user will be required to change it after the first login. To create a password that is persistent, flip the *Temporary* switch from *On* to *Off* before clicking *Reset Password*.
-. Click *Reset Password* to reset the user password to the new one you specified.  
-
-NOTE: This password is temporary and the user will be required to change it after first login. You can make it permanent
-by flipping the *Temporary* switch from *On* to *Off* before clicking *Reset Password*.