Author: jaredmorgs Date: 2013-05-15 02:20:24 -0400 (Wed, 15 May 2013) New Revision: 9279 Modified: epp/docs/JPP/trunk/User_Guide/en-US/Revision_History.xml epp/docs/JPP/trunk/User_Guide/en-US/modules/Supported_Browsers.xml epp/docs/JPP/trunk/User_Guide/en-US/modules/account/Sign_in_and_Sign_out.xml epp/docs/JPP/trunk/User_Guide/en-US/modules/portal/Manage_Portals.xml epp/docs/JPP/trunk/User_Guide/en-US/modules/portal/User_Management.xml epp/docs/JPP/trunk/User_Guide/en-US/modules/portletsUser/Dashboard_Portlet.xml epp/docs/JPP/trunk/User_Guide/en-US/modules/portletsUser/Interface_Portlets.xml epp/docs/JPP/trunk/User_Guide/en-US/modules/terms/Permission_levels.xml epp/docs/JPP/trunk/User_Guide/en-US/modules/terms/Toolbar_concept.xml Log: BZ#921356 - Removed all instances of Refer to in the guide, and replaced with See instead. Modified: epp/docs/JPP/trunk/User_Guide/en-US/Revision_History.xml =================================================================== --- epp/docs/JPP/trunk/User_Guide/en-US/Revision_History.xml 2013-05-15 02:20:21 UTC (rev 9278) +++ epp/docs/JPP/trunk/User_Guide/en-US/Revision_History.xml 2013-05-15 06:20:24 UTC (rev 9279) @@ -8,6 +8,20 @@ <simpara> <revhistory> <revision> + <revnumber>6.1.0-3</revnumber> + <date>Wed May 15 2013</date> + <author> + <firstname>Jared</firstname> + <surname>Morgan</surname> + <email/> + </author> + <revdescription> + <simplelist> + <member>BZ#921356 - Removed all instances of &quot;Refer to&quot; in the guide.</member> + </simplelist> + </revdescription> + </revision> + <revision> <revnumber>6.1.0-2</revnumber> <date>Tue Apr 30 2013</date> <author> Modified: epp/docs/JPP/trunk/User_Guide/en-US/modules/Supported_Browsers.xml =================================================================== --- epp/docs/JPP/trunk/User_Guide/en-US/modules/Supported_Browsers.xml 2013-05-15 02:20:21 UTC (rev 9278) +++ epp/docs/JPP/trunk/User_Guide/en-US/modules/Supported_Browsers.xml 2013-05-15 06:20:24 UTC (rev 9279) @@ -5,6 +5,6 @@ ]> <chapter> <title>Supported Browsers</title> - <para>For a list of supported browsers, refer to the Supported Configurations page on the Customer Portal, which is located at <ulink url="https://access.redhat.com/knowledge/articles/119833" type="http">https://access.redhat.com/knowledge/articles/119...;. + <para>For a list of supported browsers, see the Supported Configurations page on the Customer Portal, which is located at <ulink url="https://access.redhat.com/knowledge/articles/119833" type="http">https://access.redhat.com/knowledge/articles/119...;. </para> </chapter> Modified: epp/docs/JPP/trunk/User_Guide/en-US/modules/account/Sign_in_and_Sign_out.xml =================================================================== --- epp/docs/JPP/trunk/User_Guide/en-US/modules/account/Sign_in_and_Sign_out.xml 2013-05-15 02:20:21 UTC (rev 9278) +++ epp/docs/JPP/trunk/User_Guide/en-US/modules/account/Sign_in_and_Sign_out.xml 2013-05-15 06:20:24 UTC (rev 9279) @@ -60,7 +60,7 @@ </term> <listitem> <para> - To follow some steps to get the forgotten user name or password. Please refer to <xref linkend="sect-User_Guide-Account_and_Password_Retrieval"/> for more details. + To follow some steps to get the forgotten user name or password. Please see <xref linkend="sect-User_Guide-Account_and_Password_Retrieval"/> for more details. </para> </listitem> </varlistentry> Modified: epp/docs/JPP/trunk/User_Guide/en-US/modules/portal/Manage_Portals.xml =================================================================== --- epp/docs/JPP/trunk/User_Guide/en-US/modules/portal/Manage_Portals.xml 2013-05-15 02:20:21 UTC (rev 9278) +++ epp/docs/JPP/trunk/User_Guide/en-US/modules/portal/Manage_Portals.xml 2013-05-15 06:20:24 UTC (rev 9279) @@ -187,8 +187,7 @@ </para> <note> <title>Custom Portlets</title> - <para> - If you want to include a custom portlet or gadget on a page, you may wish to refer to the <emphasis>JBoss Portlet Tools User Guide</emphasis> in the JBoss Developer Studio documentation (<ulink url="http://docs.redhat.com/docs/en-US/JBoss_Developer_Studio/" type="http"/>) and/or the <emphasis role="bold">Portlet development</emphasis> section of the <emphasis>JBoss Portal Platform Reference Guide</emphasis> (<ulink url="http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platf... type="http"/>) for more information about creating and deploying portlets. + <para>See the <emphasis>JBoss Portlet Tools User Guide</emphasis> in the JBoss Developer Studio documentation (<ulink url="http://docs.redhat.com/docs/en-US/JBoss_Developer_Studio/" type="http"/>) and/or the <emphasis role="bold">Portlet development</emphasis> section of the <emphasis>JBoss Portal Platform Reference Guide</emphasis> (<ulink url="http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platf... type="http"/>) for more information about creating and deploying portlets. </para> </note> </section> Modified: epp/docs/JPP/trunk/User_Guide/en-US/modules/portal/User_Management.xml =================================================================== --- epp/docs/JPP/trunk/User_Guide/en-US/modules/portal/User_Management.xml 2013-05-15 02:20:21 UTC (rev 9278) +++ epp/docs/JPP/trunk/User_Guide/en-US/modules/portal/User_Management.xml 2013-05-15 06:20:24 UTC (rev 9279) @@ -311,8 +311,7 @@ <para> Click on the magnify glass to open up the User selector. </para> - <para> - Refer to <xref linkend="sect-User_Guide-User_Management-Search_a_user"/> for instructions on how to locate a user. + <para>See <xref linkend="sect-User_Guide-User_Management-Search_a_user"/> for instructions on how to locate a user. </para> <para> Check the box next to the user name then click <emphasis role="bold">Add</emphasis> @@ -403,7 +402,7 @@ <guimenu>Organization</guimenu> <guimenu>Users and Groups Management</guimenu> </menuchoice> Membership Management window, with the Add/Edit Membership fields displayed. </phrase> - </textobject> + </textobject> </mediaobject> <section id="sect-User_Guide-User_Management-Add_a_new_membership_type"> <title>Add a new membership type</title> Modified: epp/docs/JPP/trunk/User_Guide/en-US/modules/portletsUser/Dashboard_Portlet.xml =================================================================== --- epp/docs/JPP/trunk/User_Guide/en-US/modules/portletsUser/Dashboard_Portlet.xml 2013-05-15 02:20:21 UTC (rev 9278) +++ epp/docs/JPP/trunk/User_Guide/en-US/modules/portletsUser/Dashboard_Portlet.xml 2013-05-15 06:20:24 UTC (rev 9279) @@ -143,7 +143,7 @@ Only gadgets that have been added to the whitelist by the administrator can be used. </para> <para> - For more information, refer to the <emphasis>Gadget Proxy Configuration</emphasis> Chapter of the JBoss Portal Platform Installation Guide available at <ulink url="http://docs.redhat.com" type="http"/>. + For more information, see the <emphasis>Gadget Proxy Configuration</emphasis> Chapter of the JBoss Portal Platform Installation Guide available at <ulink url="http://docs.redhat.com" type="http"/>. </para> </important> <para> Modified: epp/docs/JPP/trunk/User_Guide/en-US/modules/portletsUser/Interface_Portlets.xml =================================================================== --- epp/docs/JPP/trunk/User_Guide/en-US/modules/portletsUser/Interface_Portlets.xml 2013-05-15 02:20:21 UTC (rev 9278) +++ epp/docs/JPP/trunk/User_Guide/en-US/modules/portletsUser/Interface_Portlets.xml 2013-05-15 06:20:24 UTC (rev 9279) @@ -68,7 +68,7 @@ This portlet is used for hosting mini-applications known as gadgets. The dashboard uses a variety of graphical effects for displaying, opening, and using gadgets. </para> <para> - Refer to <xref linkend="sect-User_Guide-Dashboard_Portlet"/> or <xref linkend="chap-User_Guide-Gadgets_Administration"/> for more information. +see <xref linkend="sect-User_Guide-Dashboard_Portlet"/> or <xref linkend="chap-User_Guide-Gadgets_Administration"/> for more information. </para> </listitem> </varlistentry> Modified: epp/docs/JPP/trunk/User_Guide/en-US/modules/terms/Permission_levels.xml =================================================================== --- epp/docs/JPP/trunk/User_Guide/en-US/modules/terms/Permission_levels.xml 2013-05-15 02:20:21 UTC (rev 9278) +++ epp/docs/JPP/trunk/User_Guide/en-US/modules/terms/Permission_levels.xml 2013-05-15 06:20:24 UTC (rev 9279) @@ -1,70 +1,74 @@ -<?xml version='1.0' encoding='utf-8' ?> +<?xml version='1.0' encoding='UTF-8'?> <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ <!ENTITY % BOOK_ENTITIES SYSTEM "../../User_Guide.ent"> %BOOK_ENTITIES; ]> <section id="sect-User_Guide-Permissions"> - <title>Permissions</title> - <para> - Permission settings control what users can and cannot do within the portal and are set by portal administrators. - </para> - <para> - Permission <emphasis role="bold">types</emphasis> dictate what a user can do within the portal. Two permission types are available as follows: - </para> - - <variablelist> - <varlistentry> - <term><emphasis role="bold">Access</emphasis></term> - <listitem> - <para> - This permission type allows users to utilize portal content, that is; sign in, rearrange portlets, etc. This permission can be set for multiple member groups. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis role="bold">Edit</emphasis></term> - <listitem> - <para> - This permission type allows users to change portal content. This includes actions such as changing page information, deleting pages etc. The <emphasis>edit</emphasis> permission is set for only one group at a time. - </para> - </listitem> - </varlistentry> - </variablelist> - - <para> - Permission <emphasis role="bold"> levels</emphasis> dictate <emphasis>where</emphasis> in the portal the user's permission type applies. There are three permission levels: - </para> - - <variablelist> - <varlistentry> - <term><emphasis role="bold">Portal</emphasis></term> - <listitem> - <para> - The portal permission level includes all pages within the portal. Therefore, a user with the <emphasis role="bold">access</emphasis> permission type can view (but not edit) all the pages within the portal. A user with <emphasis role="bold">edit</emphasis> permission at the portal level, can change any page in the portal. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis role="bold">Page</emphasis></term> - <listitem> - <para> - The page permission level restricts the user to particular pages. Users are only able to see and/or edit (depending on their permission <emphasis role="bold">type</emphasis>) pages they have been given access to. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis role="bold">Portlet</emphasis></term> - <listitem> - <para> - The portlet permission level allows users to create a page by dragging and dropping portlets into a page. Some portlets are only used for administrators while some are used for individuals thus administrators have to set the appropriate access permissions. - </para> - </listitem> - </varlistentry> - </variablelist> - - <para> - Permission <emphasis role="bold">types</emphasis> and <emphasis role="bold">levels</emphasis> can be used to effectively control who can do what within the portal. For more information on setting permissions refer to <xref linkend="sect-User_Guide-Manage_Permissions"/> - </para> + <title>Permissions</title> + <para> + Permission settings control what users can and cannot do within the portal and are set by portal administrators. + </para> + <para> + Permission <emphasis role="bold">types</emphasis> dictate what a user can do within the portal. Two permission types are available as follows: + </para> + <variablelist> + <varlistentry> + <term> + <emphasis role="bold">Access</emphasis> + </term> + <listitem> + <para> + This permission type allows users to utilize portal content, that is; sign in, rearrange portlets, etc. This permission can be set for multiple member groups. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <emphasis role="bold">Edit</emphasis> + </term> + <listitem> + <para> + This permission type allows users to change portal content. This includes actions such as changing page information, deleting pages etc. The <emphasis>edit</emphasis> permission is set for only one group at a time. + </para> + </listitem> + </varlistentry> + </variablelist> + <para> + Permission <emphasis role="bold"> levels</emphasis> dictate <emphasis>where</emphasis> in the portal the user&apos;s permission type applies. There are three permission levels: + </para> + <variablelist> + <varlistentry> + <term> + <emphasis role="bold">Portal</emphasis> + </term> + <listitem> + <para> + The portal permission level includes all pages within the portal. Therefore, a user with the <emphasis role="bold">access</emphasis> permission type can view (but not edit) all the pages within the portal. A user with <emphasis role="bold">edit</emphasis> permission at the portal level, can change any page in the portal. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <emphasis role="bold">Page</emphasis> + </term> + <listitem> + <para> + The page permission level restricts the user to particular pages. Users are only able to see and/or edit (depending on their permission <emphasis role="bold">type</emphasis>) pages they have been given access to. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <emphasis role="bold">Portlet</emphasis> + </term> + <listitem> + <para> + The portlet permission level allows users to create a page by dragging and dropping portlets into a page. Some portlets are only used for administrators while some are used for individuals thus administrators have to set the appropriate access permissions. + </para> + </listitem> + </varlistentry> + </variablelist> + <para> + Permission <emphasis role="bold">types</emphasis> and <emphasis role="bold">levels</emphasis> can be used to effectively control who can do what within the portal. For more information on setting permissions see <xref linkend="sect-User_Guide-Manage_Permissions"/> + </para> </section> - - Modified: epp/docs/JPP/trunk/User_Guide/en-US/modules/terms/Toolbar_concept.xml =================================================================== --- epp/docs/JPP/trunk/User_Guide/en-US/modules/terms/Toolbar_concept.xml 2013-05-15 02:20:21 UTC (rev 9278) +++ epp/docs/JPP/trunk/User_Guide/en-US/modules/terms/Toolbar_concept.xml 2013-05-15 06:20:24 UTC (rev 9279) @@ -1,29 +1,23 @@ -<?xml version='1.0' encoding='utf-8' ?> +<?xml version='1.0' encoding='UTF-8'?> <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ <!ENTITY % BOOK_ENTITIES SYSTEM "../../User_Guide.ent"> %BOOK_ENTITIES; ]> <section id="sect-User_Guide-Toolbar-Concept"> - <title>Toolbar</title> - <para> - The Toolbar spans the top of the portal application and provides links to user and administrative actions. + <title>Toolbar</title> + <para> + The Toolbar spans the top of the portal application and provides links to user and administrative actions. </para> - <!-- DOCS NOTE: BZ#856442 +<!-- DOCS NOTE: BZ#856442 <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/Toolbar.png" format="PNG" align="center" scale="110"/> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/Toolbar.png" format="PNG" align="center" scalefit="1" contentwidth="150mm"/> - </imageobject> - </mediaobject> - --> - <para> - This screenshot displays three Navigations referred to in <xref linkend="sect-User_Guide-Navigation" /> as well as the main Menu button (on the far left of the toolbar) and the name of the current user (on the far right). - </para> - <para> - In this example the current user is the site administrator, hence the extra "Site Editor" menu. - </para> + <imageobject role="html"> + <imagedata fileref="images/Toolbar.png" format="PNG" align="center" scale="110"/> + </imageobject> + <imageobject role="fo"> + <imagedata fileref="images/Toolbar.png" format="PNG" align="center" scalefit="1" contentwidth="150mm"/> + </imageobject> + </mediaobject> + --> <para> +There are three Navigations referred to in <xref linkend="sect-User_Guide-Navigation"/> as well as the main Menu button (on the far left of the toolbar) and the name of the current user (on the far right). + </para> </section> - -