[gatein-commits] gatein SVN: r1155 - in portal/trunk/docs/user-guide/en/modules: account and 1 other directory.

Author: smumford Date: 2010-01-03 20:45:02 -0500 (Sun, 03 Jan 2010) New Revision: 1155 Modified: portal/trunk/docs/user-guide/en/modules/Account.xml portal/trunk/docs/user-guide/en/modules/account/Account_and_Password_Retrieval.xml portal/trunk/docs/user-guide/en/modules/account/Change_Account_Settings.xml portal/trunk/docs/user-guide/en/modules/account/Register_New_Accounts.xml portal/trunk/docs/user-guide/en/modules/account/Sign_in_and_Sign_out.xml Log: Chapter 4 copy edit Modified: portal/trunk/docs/user-guide/en/modules/Account.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/Account.xml 2010-01-01 18:01:10 UTC (rev 1154) +++ portal/trunk/docs/user-guide/en/modules/Account.xml 2010-01-04 01:45:02 UTC (rev 1155) @@ -23,10 +23,11 @@ --><title>Accounts</title> <xi:include href="account/Register_New_Accounts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="account/Change_User_Password.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="account/Sign_in_and_Sign_out.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="account/Remember_User_Account.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="account/Change_Account_Settings.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="account/Sign_in_and_Sign_out.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> +<!-- <xi:include href="account/Change_User_Password.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - Covered in Change_Account_Setings.xml --> <xi:include href="account/Account_and_Password_Retrieval.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="account/Remember_User_Account.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + </chapter> Modified: portal/trunk/docs/user-guide/en/modules/account/Account_and_Password_Retrieval.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/account/Account_and_Password_Retrieval.xml 2010-01-01 18:01:10 UTC (rev 1154) +++ portal/trunk/docs/user-guide/en/modules/account/Account_and_Password_Retrieval.xml 2010-01-04 01:45:02 UTC (rev 1155) @@ -23,26 +23,23 @@ --><title>Account and Password Retrieval</title> <para> - This feature is really useful when you forget your account or password by recovering it quickly through following simple steps: + Should you forget your account or password you can recover it quickly by following these simple steps: </para> <procedure> <step> <para> - Show the form that guides you step by step in recovering your User name/ Password by clicking the link 'Forget your User Name/Password?' beneath the <emphasis role="bold">Password</emphasis> field of the <emphasis role="bold">Sign in</emphasis> form. + Click the link 'Forget your User Name/Password?' (beneath the <emphasis role="bold">Password</emphasis> field of the <emphasis role="bold">Sign in</emphasis> form). This presents the form that guides you through recovering your username and/or password. </para> <mediaobject> <imageobject> <imagedata fileref="images/SignIn1.png" format="PNG" width="444" /> </imageobject> </mediaobject> + </step> + <step> <para> This form offers two options to select: </para> - <mediaobject> - <imageobject> - <imagedata fileref="images/Forgot1.png" format="PNG" width="444" /> - </imageobject> - </mediaobject> <itemizedlist> <listitem> <para> @@ -55,20 +52,23 @@ </para> </listitem> </itemizedlist> - </step> - <step> + <mediaobject> + <imageobject> + <imagedata fileref="images/Forgot1.png" format="PNG" width="444" /> + </imageobject> + </mediaobject> <para> - Select one of two options in this form. + Select the appropriate option and click <emphasis role="bold">Next</emphasis>. </para> </step> <step> <para> - Click the <emphasis role="bold">Next</emphasis> button to go to the next step: + You will be prompted to provide identification information depending on which option you selected: </para> <itemizedlist> <listitem> <para> - If you selected <emphasis role="bold">Forgot my password</emphasis> option: + If you selected <emphasis role="bold">Forgot my password</emphasis> option you will be prompted for your <emphasis role="bold">Username</emphasis>: </para> <mediaobject> <imageobject> Modified: portal/trunk/docs/user-guide/en/modules/account/Change_Account_Settings.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/account/Change_Account_Settings.xml 2010-01-01 18:01:10 UTC (rev 1154) +++ portal/trunk/docs/user-guide/en/modules/account/Change_Account_Settings.xml 2010-01-04 01:45:02 UTC (rev 1155) @@ -22,15 +22,12 @@ 02110-1301 USA, or see the FSF site: http://www.fsf.org. --><title>Change Account Settings</title> - <!-- <para> - There are two ways to change the account information: - </para> - <title>The 1^st^ way</title> --> + <para> - All users can follow this guides to change your account information. + Users can follow this guide to change account information. </para> <para> - To change your account information, you just click on your account: + To change your account information, click on the account name in the top navigation bar: </para> <mediaobject> <imageobject> @@ -46,22 +43,22 @@ </imageobject> </mediaobject> <para> - If you want to change your <emphasis role="bold">Account Profiles</emphasis> : + If you want to change your Account Profile information: </para> <procedure> <step> <para> - Select the <emphasis role="bold">Account Profiles</emphasis> tab. It will display your current basic information. + Select the <emphasis role="bold">Account Profiles</emphasis> tab. This will display your current basic information. </para> </step> <step> <para> - Your <emphasis role="bold">User Name</emphasis> can not be changed. You can change these fields: <emphasis role="bold">First Name</emphasis> , <emphasis role="bold">Last Name</emphasis> and <emphasis role="bold">Email</emphasis> . + Your <emphasis role="bold">User Name</emphasis> cannot be changed. You can change your: <emphasis role="bold">First Name</emphasis> , <emphasis role="bold">Last Name</emphasis> and <emphasis role="bold">Email</emphasis>. </para> </step> <step> <para> - Click the <emphasis role="bold">Save</emphasis> button to accept changes. + Once the desired changes have been made, click the <emphasis role="bold">Save</emphasis> button to submit them. </para> </step> </procedure> @@ -71,7 +68,7 @@ <procedure> <step> <para> - Select the <emphasis role="bold">Change Password</emphasis> tab, it will display a form: + Select the <emphasis role="bold">Change Password</emphasis> tab, it will display the following form: </para> <mediaobject> <imageobject> @@ -91,7 +88,7 @@ </step> <step> <para> - Reinput your password in the <emphasis role="bold">Confirm New Password</emphasis> field. + Re-enter your password in the <emphasis role="bold">Confirm New Password</emphasis> field. </para> </step> <step> @@ -100,18 +97,7 @@ </para> </step> </procedure> - <!-- - <section> - <title>The 2^nd^ way</title> - <para>Only users who have the permission to access GateIn start in - the - User Workspace can follow this way.</para> - <para> - Go to - <emphasis role="bold">GateIn Start</emphasis> - -&gt; <emphasis role="bold">Administration</emphasis> -&gt; <emphasis role="bold">Account Settings</emphasis></para><mediaobject><imageobject><imagedata fileref="images/ChangeLanguage3.png" format="PNG"></imagedata></imageobject></mediaobject><para>It will also open the <emphasis role="bold">Account Profiles</emphasis> form.</para><mediaobject><imageobject><imagedata fileref="images/AccountProfiles1.png" format="PNG"></imagedata></imageobject></mediaobject><para>You can change your information in the <emphasis role="bold">Account Profiles</emphasis> tab and the <emphasis role="bold">Change Password</emphasis> tab as the same as the first way.</para> - </section> --> </section> Modified: portal/trunk/docs/user-guide/en/modules/account/Register_New_Accounts.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/account/Register_New_Accounts.xml 2010-01-01 18:01:10 UTC (rev 1154) +++ portal/trunk/docs/user-guide/en/modules/account/Register_New_Accounts.xml 2010-01-04 01:45:02 UTC (rev 1155) @@ -23,7 +23,7 @@ --><title>Register New Accounts</title> <para> - Users who visit the Portal and who are not registered are limited in the content they can see. User who need access to deeper content or who need to undertake actions within the prtal should register themselves and then contact the portal administrator to have appropriate permissions added to their account. + Users who visit the Portal and who are not registered are limited in the content they can see. Users who need access to deeper content or who need to undertake actions within the prtal should register themselves and then contact the portal administrator to have appropriate permissions added to their account. </para> <para> Users can quickly and easily register a new account by themselves. Just by completing the steps below, you will have a new account that helps you access more pages and take more actions in &PRODUCT;: @@ -72,7 +72,7 @@ <term>Confirm Password</term> <listitem> <para> - Re-type the password above. *Password* and *Confirm Password* must be the same. + Re-type the password above. The <emphasis>Password</emphasis> and <emphasis>Confirm Password</emphasis> fields must be the same. </para> </listitem> </varlistentry> @@ -117,7 +117,7 @@ Input values in the <emphasis role="bold">User Profile</emphasis> tab, include: Profile information, Home information, Business information. These fields are not required. </para> <para> - &PRODUCT; facilitates users with four commonly used languagues: English, French, Vietnamese and Arabic in the <emphasis role="bold">Language</emphasis> field. You can select one of these languages to work with. + &PRODUCT; facilitates four commonly used languagues: English, French, Vietnamese and Arabic in the <emphasis role="bold">Language</emphasis> field. You can select one of these languages to work with. </para> <mediaobject> <imageobject> @@ -127,7 +127,7 @@ </step> <step> <para> - Click <emphasis role="bold">Save</emphasis> to register a new account or <emphasis role="bold">Reset</emphasis> to refresh all entered values. There will be an alert message and you can not add a new account if one of these cases occurs: + Click <emphasis role="bold">Save</emphasis> to register a new account or <emphasis role="bold">Reset</emphasis> to refresh all entered values. You cannot add a new account if one of these cases occurs: </para> <itemizedlist> <listitem> Modified: portal/trunk/docs/user-guide/en/modules/account/Sign_in_and_Sign_out.xml =================================================================== --- portal/trunk/docs/user-guide/en/modules/account/Sign_in_and_Sign_out.xml 2010-01-01 18:01:10 UTC (rev 1154) +++ portal/trunk/docs/user-guide/en/modules/account/Sign_in_and_Sign_out.xml 2010-01-04 01:45:02 UTC (rev 1155) @@ -24,7 +24,7 @@ --><title>Sign In and Sign Out</title> <para> - After registering your account, you can easily sign in to &PRODUCT; to go into your private mode: + After registering your account, you can sign in to &PRODUCT; to go into your private mode. </para> <procedure> <title>Sign In</title> @@ -35,7 +35,7 @@ </step> <step> <para> - Click the <emphasis role="bold">Sign in</emphasis> link at the top right of a page if you are current in the Classic portal. The <emphasis role="bold">Sign in</emphasis> form appears: + Click the <emphasis role="bold">Sign in</emphasis> link at the top right of the page if you are current in the Classic portal. The <emphasis role="bold">Sign in</emphasis> form appears: </para> <mediaobject> <imageobject> @@ -55,79 +55,77 @@ </step> <step> <para> - Click the <emphasis role="bold">Sign in</emphasis> button to accept or <emphasis role="bold">Discard</emphasis> to escape the <emphasis role="bold">Sign in</emphasis> form. + Click the <emphasis role="bold">Sign in</emphasis> button to submit the form or <emphasis role="bold">Discard</emphasis> to escape. </para> </step> <step> <para> Details: </para> - <informaltable colsep="0" frame="none" rowsep="0"> - <tgroup cols="2"> - <colspec align="center"></colspec> - <colspec align="center"></colspec> - <tbody> - <row> - <entry> - <emphasis role="bold"> Field </emphasis> - </entry> - <entry> - <emphasis role="bold"> Description </emphasis> - </entry> - </row> - <row> - <entry> + <variablelist> + <varlistentry> + <term> User name - </entry> - <entry> + </term> + <listitem> + <para> The registered user name. - </entry> - </row> - <row> - <entry> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> Password - </entry> - <entry> + </term> + <listitem> + <para> The registered password. - </entry> - </row> - <row> - <entry> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> Remember My Login - </entry> - <entry> - This option allows users to return to &PRODUCT; and be automatically authenticated based on the value of a cookie provided by the browser. Thus users do not have to perform an explicit authentication again. - </entry> - </row> - <row> - <entry> + </term> + <listitem> + <para> + This option allows users to return to &PRODUCT; and be automatically authenticated based on the value of a cookie provided by the bvarlistentryser. Thus users do not have to perform an explicit authentication again. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> Forgot your User Name/Password? - </entry> - <entry> + </term> + <listitem> + <para> To follow some steps to get the forgotten user name or password. Please refer [Portal:Account and Password Retrieval] for more details. - </entry> - </row> - <row> - <entry> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> Sign in - </entry> - <entry> + </term> + <listitem> + <para> To sign into &PRODUCT; with user name and password. - </entry> - </row> - <row> - <entry> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> Discard - </entry> - <entry> + </term> + <listitem> + <para> To close the *Sign In* form. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> + </para> + </listitem> + </varlistentry> + </variablelist> <para> - In case, <emphasis role="bold">User Name</emphasis> does not exist or the inputted User name/Password is invalid, there will be an alert message requires you to input the right value. To login again, you click the <emphasis role="bold">OK</emphasis> button on the alert message and enter <emphasis role="bold">User Name</emphasis> and <emphasis role="bold">Password</emphasis> again. + If <emphasis role="bold">User Name</emphasis> does not exist or the User name/Password is invalid an alert message will appear. This alert requires you to input a recognised value. To attempt the login again; click the <emphasis role="bold">OK</emphasis> button on the alert message to be returned to the Sign In form. Enter <emphasis role="bold">User Name</emphasis> and <emphasis role="bold">Password</emphasis> again. </para> <para> After signing in, you will be redirected to the authenticated homepage: