Bug 813776

Summary: User guide comments
Product: [JBoss] JBoss Enterprise Portal Platform 5 Reporter: vramik
Component: DocumentationAssignee: JPP Docs Team <jpp-docs>
Status: VERIFIED --- QA Contact:
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 5.2.1.GACC: epp-bugs, mvecera, vramik
Target Milestone: ---   
Target Release: 5.2.1.Docs.GA   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: 813333 Environment:
Last Closed: Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On: 813333    
Bug Blocks: 848574    

Description vramik 2012-04-18 12:20:00 UTC
Comments for user guide (version is 5.2.1 CR02 at the time of creation)

- Chapter 2. Supported Browsers - Firefox (versions 3.5 to 7) -> Firefox (versions 3.5 to 10)

- 4.1 - Account Portlet - update screenshot (new input field Display name is missing)

- 5.1 - 1. - update screenshot below "The Register New Account page appears: " (new input field Display name is missing)

- 5.1 - 1. - user name - ... start with a character. Only alpha, digit, underscore, dash and dot characters are allowed -> ... start with a lowercase letter and end with a lowercase letter or digit. Only lowercase letters, digits, dot and underscore characters are allowed

- 5.1 - 1. - add description about new Display Name input field according to https://bugzilla.redhat.com/show_bug.cgi?id=794235 , to summarize this: There is new input field "Display Name" when creating or editing user. The field is mandatory and if you leave it blank the display name is constructed from first name and last name. The display name is shown in right top corner when user is logged.

- 5.2.1 - ... redirected to the GateIn Sign In form. -> ... redirected to the JBoss EPP Sign In form.

- 5.4 - Account Profiles - update screenshot (new input field Display name is missing)

- 5.4 - ... You can change your: First Name , Last Name and Email. -> ... You can change your: First Name , Last Name, Display Name and Email.

- 6.2.1 - update both screenshots and descriptions of point 3 and 4 (because the order of tabs has changed)

- 6.2.5 and 6.2.6 - in my opinion this two chapters should be in the end of chapter 6.2, so 6.2.5 -> 6.2.9 and 6.2.6 -> 6.2.10

- 6.2.7. Edit Properties - ... clicking on Site in the Toolbar and selecting the Edit Portal Properties link -> ... clicking on Site in the Toolbar and selecting the Edit Portal's Config link

- 6.2.9. Change Portal Skins - Method One - 1. Click on Site, then Edit Portal's Properties. -> 1. Click on Site, then Edit Portal's Config. 

- 6.2.9. Change Portal Skins - Method One - update screenshot (there are not displayed Label and Description input fields)

- 6.3.2 - update second screenshot (there is missing Publication date & time checkbox)

- 6.5.1.1 - update screenshot (new input field Display name is missing)

- 6.5.1.1 - 3. - update description (since 5.2.1 Display Name is not required, but when blank it's constructed from first name and last name)

- 6.5.1.3 - update screenshot (new input field Display name is missing)

- 6.5.1.3 - 3. - ... Other fields First Name , Last Name , Email Address can be changed. -> ... Other fields First Name, Last Name, Display Name and Email Address can be changed. 

- 6.6.1 - Existing portals - ... Edit Portal's Properties -> ... Edit Portal's Config

- 7.3 - green box - There is info: In JBoss Enterprise Portal Platform 5.2.1 a new localization functionality called Extended Label Mode has been implemented. But this functionality was implemented in 5.2.0 so I suppose to change desc to something like: Since JBoss Enterprise Portal Platform 5.2.0 ...

Comment 1 Jared MORGAN 2012-10-10 22:12:47 UTC
TRIAGE INFORMATION

Relevance: EPP 5.2 and EPP 6

==Task==

Make the changes as prescribed in both versions. 

If you encounter an issue with screen shots, consider carefully whether the screen shot adds value to the procedure? If it doesn't strip out the image and describe the field.

If you do need to re-capture, make a note of the screenshots in your resolution info in the bug, and I can take care of those.

==Requirements== 

Ensure you have access to:

http://svn.jboss.org/repos/gatein/epp/docs/branches/5.2/ and http://svn.jboss.org/repos/gatein/epp/docs/branches/6.0/

to make changes to these guides.

==Resolving==

Add Revision History to each guide, and stage the books. 

Commit changes to SVN

Update the BZ with tracking info.

Comment 2 Petr Penicka 2012-11-08 16:44:16 UTC
Fixed in both 5.2 and 6.0. Changes staged and committed to SVN repos. Comments inline below.

Chapter 2. Supported Browsers - Firefox (versions 3.5 to 7) -> Firefox (versions 3.5 to 10)
-- FIXED

- 4.1 - Account Portlet - update screenshot (new input field Display name is missing)
-- SCREENSHOT UPDATED

- 5.1 - 1. - update screenshot below "The Register New Account page appears: " (new input field Display name is missing)
-- REMOVED THE SCREENSHOTS IN 5.2 AS IT HAS ALREADY BEEN DONE IN 6.0

- 5.1 - 1. - user name - ... start with a character. Only alpha, digit, underscore, dash and dot characters are allowed -> ... start with a lowercase letter and end with a lowercase letter or digit. Only lowercase letters, digits, dot and underscore characters are allowed
-- FIXED

- 5.1 - 1. - add description about new Display Name input field according to https://bugzilla.redhat.com/show_bug.cgi?id=794235 , to summarize this: There is new input field "Display Name" when creating or editing user. The field is mandatory and if you leave it blank the display name is constructed from first name and last name. The display name is shown in right top corner when user is logged.
-- ADDED

- 5.2.1 - ... redirected to the GateIn Sign In form. -> ... redirected to the JBoss EPP Sign In form.
-- FIXED

- 5.4 - Account Profiles - update screenshot (new input field Display name is missing)
-- SCREENSHOT UPDATED

- 5.4 - ... You can change your: First Name , Last Name and Email. -> ... You can change your: First Name , Last Name, Display Name and Email.
-- FIXED

- 6.2.1 - update both screenshots and descriptions of point 3 and 4 (because the order of tabs has changed)
-- RESTRUCTURED ACCORDING TO NEW ORDER OF TABS, REMOVED SCREENSHOTS IN 5.2 AS WAS PREVIOUSLY DONE IN 6.0

- 6.2.5 and 6.2.6 - in my opinion this two chapters should be in the end of chapter 6.2, so 6.2.5 -> 6.2.9 and 6.2.6 -> 6.2.10
-- MAKES SENSE, MOVED

- 6.2.7. Edit Properties - ... clicking on Site in the Toolbar and selecting the Edit Portal Properties link -> ... clicking on Site in the Toolbar and selecting the Edit Portal's Config link
-- FIXED

- 6.2.9. Change Portal Skins - Method One - 1. Click on Site, then Edit Portal's Properties. -> 1. Click on Site, then Edit Portal's Config. 
-- FIXED

- 6.2.9. Change Portal Skins - Method One - update screenshot (there are not displayed Label and Description input fields)
-- SCREENSHOT REMOVED (ALREADY REMOVED IN 6.0, NO ADDED VALUE)

- 6.3.2 - update second screenshot (there is missing Publication date & time checkbox)
-- MANY SCREENSHOTS REMOVED IN THIS SECTION (ALREADY REMOVED IN 6.0)

- 6.5.1.1 - update screenshot (new input field Display name is missing)
-- MANY SCREENSHOTS REMOVED IN THIS SECTION (ALREADY REMOVED IN 6.0)

- 6.5.1.1 - 3. - update description (since 5.2.1 Display Name is not required, but when blank it's constructed from first name and last name)
-- FIXED

- 6.5.1.3 - update screenshot (new input field Display name is missing)
-- MANY SCREENSHOTS REMOVED IN THIS SECTION (ALREADY REMOVED IN 6.0)

- 6.5.1.3 - 3. - ... Other fields First Name , Last Name , Email Address can be changed. -> ... Other fields First Name, Last Name, Display Name and Email Address can be changed. 
-- FIXED

- 6.6.1 - Existing portals - ... Edit Portal's Properties -> ... Edit Portal's Config
-- FIXED

- 7.3 - green box - There is info: In JBoss Enterprise Portal Platform 5.2.1 a new localization functionality called Extended Label Mode has been implemented. But this functionality was implemented in 5.2.0 so I suppose to change desc to something like: Since JBoss Enterprise Portal Platform 5.2.0 ...
-- FIXED