User doc - basis

Rewritten-docs.md

@@ -1811,58 +1811,58 @@ application follows.
 
 ### First steps in ReCodEx
 
-You can create an account if you click on the “*Create account*” menu
-item in the left sidebar. You can choose between two types of
-registration methods – by creating a local account with a specific
-password, or pairing your new account with an existing CAS UK account.
-
-If you decide a new “*local*” account using the “*Create ReCodEx
-account*” form, you will have to provide your details and choose a
-password for your account. You will later sign in using your email
-address as your username and the password you select.
-
-If you decide to use the CAS UK, then we will verify your credentials
-and access your name and email stored in the system and create your
-account based on this information. You can change your personal
-information or email later on the “*Settings*” page.
-
-When creating your account both ways, you must select an instance your
-account will belong to by default. The instance you will select will be
-most likely your university or other organization you are a member of.
-
-To log in, go to the homepage of ReCodEx and in the left sidebar choose
-the menu item “*Sign in*”. Then you must enter your credentials into one
-of the two forms – if you selected a password during registration, then
-you should sign with your email and password in the first form called
-“*Sign into ReCodEx*”. If you registered using the Charles University
-Authentication Service (CAS), you should put your student’s number and
-your CAS password into the second form called “Sign into ReCodEx using
-CAS UK”.
+You can create an account if you click on the “*Create account*” menu item in
+the left sidebar. You can choose between two types of registration methods – by
+creating a local account with a specific password, or pairing your new account
+with an existing CAS UK account.
+
+If you decide a new “*local*” account using the “*Create ReCodEx account*” form,
+you will have to provide your details and choose a password for your account.
+Although ReCodEx allows using quite weak passwords, it is wise to use a bit
+stronger ones. The actual strength is shown in progress bar near the password
+field during registration. You will later sign in using your email address as
+your username and the password you select.
+
+If you decide to use the CAS UK, then ReCodEx will verify your CAS credentials
+and create a new account based on information stored there (name and email
+address). You can change your personal information later on the “*Settings*”
+page.
+
+When creating the account both ways, an instance the account will belong to must
+be selected. The instance will be most likely your university or other
+organization you are a member of.
+
+To log in, go to the homepage of ReCodEx and in the left sidebar choose the menu
+item “*Sign in*”. Then you must enter your credentials into one of the two forms
+– if you selected a password during registration, then you should sign with your
+email and password in the first form called “*Sign into ReCodEx*”. If you
+registered using the Charles University Authentication Service (CAS), you should
+put your student’s number and your CAS password into the second form called
+“*Sign into ReCodEx using CAS UK*”.
 
 There are several options you can edit in your user account:
 
--   changing your personal information (i.e., name)
--   changing your credentials (email and password)
--   updating your preferences (e.g., source code viewer/editor settings,
-    default language)
+- changing your personal information (i.e., name)
+- changing your credentials (email and password)
+- updating your preferences (source code viewer/editor settings, default
+  language)
 
-You can access the settings page through the “*Settings*” button right
-under your name in the left sidebar.
+You can access the settings page through the “*Settings*” button right under
+your name in the left sidebar.
 
-If you don’t use ReCodEx for a whole day, you will be logged out
-automatically. However, we recommend you sign out of the application
-after you finished your interaction with it. The logout button is placed
-in the top section of the left sidebar right under your name. You will
-have to expand the sidebar with a button next to the “*ReCodEx*” title
-(shown in the picture below).
+If you do not use ReCodEx for a whole day, you will be logged out automatically.
+However, we recommend you sign out of the application after you finished your
+interaction with it. The logout button is placed in the top section of the left
+sidebar right under your name. You may need to expand the sidebar with a button
+next to the “*ReCodEx*” title (also known as _hamburger button_).
 
 ### Forgotten password
 
 If you cannot remember your password and you do not use CAS UK authentication,
 then you can reset your password. You will find a link saying “Cannot remember
 what your password was? Reset your password.” under the sign in form. After you
-click on this link, you will be asked to submit your email address. An email
-with a link containing a special token will be sent to the address you fill in.
+click on this link, you will be asked to submit your registration email address.
+A message with a link containing a special token will be sent to your address.
 We make sure that the person who requested password resetting is really you.
 When you click on the link (or you copy & paste it into your web browser) you
 will be able to select a new password for your account. The token is valid only
@@ -1875,10 +1875,10 @@ website.
 
 ### Dashboard
 
-When you log into system you should be redirected to your "Dashboard". On this
-page according to your role in system you can see some brief information about
-the groups you are member of. Further description of dashboard will be provided
-later on with according roles.
+When you log into the system you should be redirected to your "*Dashboard*". On
+this page according to your role in system you can see some brief information
+about the groups you are member of. Further description of dashboard will be
+provided later on with according roles.
 
 ## Student