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
+You can create an account if you click on the “*Create account*” menu item in
-item in the left sidebar. You can choose between two types of
+the left sidebar. You can choose between two types of registration methods – by
-registration methods – by creating a local account with a specific
+creating a local account with a specific password, or pairing your new account
-password, or pairing your new account with an existing CAS UK account.
+with an existing CAS UK account.
-
+
-If you decide a new “*local*” account using the “*Create ReCodEx
+If you decide a new “*local*” account using the “*Create ReCodEx account*” form,
-account*” form, you will have to provide your details and choose a
+you will have to provide your details and choose a password for your account.
-password for your account. You will later sign in using your email
+Although ReCodEx allows using quite weak passwords, it is wise to use a bit
-address as your username and the password you select.
+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
-If you decide to use the CAS UK, then we will verify your credentials
+your username and the password you select.
-and access your name and email stored in the system and create your
+
-account based on this information. You can change your personal
+If you decide to use the CAS UK, then ReCodEx will verify your CAS credentials
-information or email later on the “*Settings*” page.
+and create a new account based on information stored there (name and email
-
+address). You can change your personal information later on the “*Settings*”
-When creating your account both ways, you must select an instance your
+page.
-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.
+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
-To log in, go to the homepage of ReCodEx and in the left sidebar choose
+organization you are a member of.
-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
+To log in, go to the homepage of ReCodEx and in the left sidebar choose the menu
-you should sign with your email and password in the first form called
+item “*Sign in*”. Then you must enter your credentials into one of the two forms
-“*Sign into ReCodEx*”. If you registered using the Charles University
+– if you selected a password during registration, then you should sign with your
-Authentication Service (CAS), you should put your student’s number and
+email and password in the first form called “*Sign into ReCodEx*”. If you
-your CAS password into the second form called “Sign into ReCodEx using
+registered using the Charles University Authentication Service (CAS), you should
-CAS UK”.
+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,
+- updating your preferences (source code viewer/editor settings, default
-    default language)
+  language)
 
-You can access the settings page through the “*Settings*” button right
+You can access the settings page through the “*Settings*” button right under
-under your name in the left sidebar.
+your name in the left sidebar.
 
-If you don’t use ReCodEx for a whole day, you will be logged out
+If you do not use ReCodEx for a whole day, you will be logged out automatically.
-automatically. However, we recommend you sign out of the application
+However, we recommend you sign out of the application after you finished your
-after you finished your interaction with it. The logout button is placed
+interaction with it. The logout button is placed in the top section of the left
-in the top section of the left sidebar right under your name. You will
+sidebar right under your name. You may need to expand the sidebar with a button
-have to expand the sidebar with a button next to the “*ReCodEx*” title
+next to the “*ReCodEx*” title (also known as _hamburger button_).
-(shown in the picture below).
 
 ### 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
+click on this link, you will be asked to submit your registration email address.
-with a link containing a special token will be sent to the address you fill in.
+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
+When you log into the system you should be redirected to your "*Dashboard*". On
-page according to your role in system you can see some brief information about
+this page according to your role in system you can see some brief information
-the groups you are member of. Further description of dashboard will be provided
+about the groups you are member of. Further description of dashboard will be
-later on with according roles.
+provided later on with according roles.
 
 ## Student