[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Domain_Configuration_Login_Page.tex

[raeburn]

raeburn		Thu Dec  9 20:59:49 2021 EDT

  Modified files:              
    /loncom/html/adm/help/tex	Domain_Configuration_Login_Page.tex 
  Log:
  - Improved wording in log-in page documentation.
  
  
Index: loncom/html/adm/help/tex/Domain_Configuration_Login_Page.tex
diff -u loncom/html/adm/help/tex/Domain_Configuration_Login_Page.tex:1.10 loncom/html/adm/help/tex/Domain_Configuration_Login_Page.tex:1.11
--- loncom/html/adm/help/tex/Domain_Configuration_Login_Page.tex:1.10	Wed Dec  8 14:45:01 2021
+++ loncom/html/adm/help/tex/Domain_Configuration_Login_Page.tex	Thu Dec  9 20:59:49 2021
@@ -17,12 +17,12 @@
 display their log-in pages, their appearance can be customized as follows:
 
 \begin{itemize}
-\item uploading custom image files 
-\item changing colors of text, links or backgrounds 
-\item enabling/disabling display of specific links 
+\item upload of custom image files 
+\item changes to colors of text, links or backgrounds 
+\item enabled/disabled display of specific links 
 \end{itemize}
-Logos displayed in the login page configuration table are scaled down
-from the full size used in the login-page itself. 
+Note: logos displayed in the login page configuration panel are scaled down
+from the full size used in the log-in page itself. 
 
 \hfill{}
 
@@ -38,7 +38,7 @@
 (side) panel. 
 \item Text color used for text on the page
 \item Text colors used for active, visited and unvisited links
-\item Enable/disable display of four links: 
+\item Enabled/disabled display for four links: 
 
 \begin{itemize}
 \item Course/Community Catalog, for a catalog of courses and communities
@@ -46,8 +46,8 @@
 \item Contact Helpdesk, to display a web form used to submit a help request 
 \item New User, for users to create their own accounts 
 \end{itemize}
-\item Default colors for links in the page, depending on status: either
-active, visited or default (if neither apply).
+\item Default colors used for links in the page, depending on status: either
+active or visited (or default, if neither apply).
 \end{itemize}
 
 \hfill{}
@@ -92,25 +92,25 @@
 
 For a LON-CAPA node configured to support Single Sign On (SSO), e.g., by operating as a Shibboleth SP,
 entries in Apache config files (loncapa_apache.conf, if Shibboleth) will cause display of an SSO login page
-when a user without a current LON-CAPA session accesses /adm/roles.  If, instead, it is preferred
-to display /adm/login configured to offer dual SSO log-in (e.g., Shibboleth), and non-SSO login
-(i.e., LON-CAPA), that can be set using the ``Dual login: SSO and non-SSO options'' section.
+whenever a user accesses /adm/roles without a cookie for an unexpired LON-CAPA session.  If it is preferred
+instead to display /adm/login configured to offer dual SSO log-in (e.g., Shibboleth), and non-SSO login
+(i.e., LON-CAPA), that will be set via the ``Dual login: SSO and non-SSO options'' section.
 
-Check the ``Yes'' radio button for each of the domain's servers which will offer dual login check "Yes" and then set:  
+Check the ``Yes'' radio button for each of the domain's servers which will offer dual login and then set:  
 
 \begin{itemize}
 \item SSO: Text, Image, Alt Text, URL, Tool Tip
 \item non-SSO: Text
 \end{itemize}
 
-The value in the URL field will be /adm/sso for Shibboleth, and the image will be for a button to be clicked
-to load /adm/sso to prompt for SSO login. The alt and title attributes for the button can also be set.
+The value in the URL field will be /adm/sso for Shibboleth, and an uploaded image file will provide the button to be clicked
+to load /adm/sso (i.e., to prompt an SSO login). The alt and title attributes for the button can also be set.
 
 With this in effect the LON-CAPA login page /adm/login will display the following:
 
 \begin{itemize}
 \item Log-in type:
-Immediately followed by the text for either SSO, or non-SSO login, as entered in the ``Dual login: SSO and non-SSO options'' 
+Immediately followed by the text for either SSO, or non-SSO login, as set via the ``Dual login: SSO and non-SSO options'' 
 textboxes for SSO and non-SSO.
 
 \item Change?
@@ -120,7 +120,7 @@
 
 \begin{itemize}
 
-\item SSO - an image (i.e., clickable button) which as uploaded in the SSO option item, with alt text, and a tool tip
+\item SSO - an image (i.e., clickable button) which was uploaded in the SSO option item, with alt text, and a tool tip
 shown when hovering over the button.
 
 \item Non-SSO - standard LON-CAPA login box for username, password, domain and "Log In" button.
@@ -131,7 +131,7 @@
 
 If the SSO service is something other than Shibboleth (e.g., CAS or Sentinel) and the PerlVar lonOtherAuthenUrl has
 been set to a preferred URL (e.g., /adm/sentinel), then the URL item in the SSO entry in the dual login options
-should be set to that preferred URL also.
+should be set to that same preferred URL.
 
 Note: if the original page request by an unauthenticated user included a query string with any of the following items:
 role, symb, and linkkey, then they will be stored in a token file on the server, for access later to support deep-linking.