Bug 793811 (JBEPP-886)

Summary: Docs: Clarify necessary group membership to see the top toolbar when Site Publisher is installed
Product: [JBoss] JBoss Enterprise Portal Platform 5 Reporter: Martin Weiler <mweiler>
Component: DocumentationAssignee: Scott Mumford <smumford>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: 5.1.0.Docs.GA   
Target Milestone: ---   
Target Release: 5.1.1.Docs.GA   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/JBEPP-886
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
EPP 5.1 + SitePublisher
Last Closed: 2011-08-15 04:38:53 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Bug Depends On:    
Bug Blocks: 793732    

Description Martin Weiler 2011-04-13 09:53:52 UTC 
Affects: Documentation (Ref Guide, User Guide, etc.)
Help Desk Ticket Reference: https://na7.salesforce.com/500A00000079AMR
project_key: JBEPP

Sections 3.1.2 and 3.1.3 of the SP User Guide are not entirely correct when it comes to viewing the top toolbar:
http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platform/5.1/html/Site_Publisher_User_Guide/chap-User_Guide-Get_Started.html#sect-User_Guide-Account

"After signing in, you will be redirected to the authenticated homepage like the illustration." 
The screenshot that is shown afterwards includes the top toolbar, but this top toolbar is only displayed when the user is also member of the /platform/web-contributors role. This is not the case per default for newly registered users.

The same applies to the Sign Out instructions.

We should document the necessity of adding a new user to the /platform/web-contributors role for the top toolbar to be displayed somewhere in this Chapter. See also this KBase article for potential approaches to address this: https://access.redhat.com/kb/docs/DOC-54051
Comment 1 Scott Mumford 2011-04-13 23:39:49 UTC 
Release Notes Docs Status: Added: Not Required
Comment 2 Scott Mumford 2011-04-13 23:44:02 UTC 
Affects: Added: [Documentation (Ref Guide, User Guide, etc.)]
Comment 3 Scott Mumford 2011-04-15 04:12:44 UTC 
Subject Matter Expert: Added: smumford
NEEDINFO: Added: Nobody
Comment 4 Scott Mumford 2011-04-15 04:13:34 UTC 
Subject Matter Expert: Removed: smumford 
NEEDINFO: Removed: Nobody
Comment 5 Scott Mumford 2011-04-19 04:36:47 UTC 
Link: Added: This issue is a dependency of JBEPP-803
Comment 6 Scott Mumford 2011-07-05 07:17:20 UTC 
Draft content has been added to the SP User Guide to resolve this issue: Section 3.1.6. "Toolbar Visibility" (an admonition has also been added to Section 3.1.2. "Sign In")

A new version of the doc is available on the Docs Stage; http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platform/5.1/html-single/Site_Publisher_User_Guide/index.html#sect-User_Guide-Account-Toolbar_Visibility

The new content needs to be reviewed for technical accuracy before the patch can be approved by eXo and the update committed permanently.