Bug 616810

Summary: Make sure release notes describe resource name changes
Product: [Other] RHQ Project Reporter: Charles Crouch <ccrouch>
Component: DocumentationAssignee: Charles Crouch <ccrouch>
Status: CLOSED CURRENTRELEASE QA Contact: Corey Welton <cwelton>
Severity: medium Docs Contact:
Priority: urgent    
Version: unspecifiedCC: hbrock, lkrejci, mfoley
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-05-24 01:07:50 UTC Type: ---
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:    
Bug Blocks: 601949    

Description Charles Crouch 2010-07-21 13:25:11 UTC
We should also highlight the fact these changes will not be made retroactively to the name of resources already in inventory

Comment 1 Deon Ballard 2010-07-22 15:56:30 UTC
Here is the link in the release notes:
http://elladeon.fedorapeople.org/jon-drafts/3.0/rel-notes/changes-in-behavior.html#resource-names

Text

==============

2.2. New Resource Naming Scheme

The default naming method for resources has been simplified. The changes depend on resource type, but names have been shortened to display only as much context as is required, usually the hostname or instance name, IP address, or other identifying name. These names are expanded when the same types of resources are available on multiple hosts or have multiple instances on the same host to provide additional identifiers while still keeping the name concise. This makes resource names clearer and more user-friendly, while making the resource tree navigation easier to read and use.

The resource naming scheme only applies to new resources imported into inventory. Existing resources on JBoss ON server which are migrated to version 2.4 will retain their original resource names. 

=============

Comment 2 Charles Crouch 2010-07-27 12:41:17 UTC
Joseph, can you correct the text in this paragraph

Comment 3 Lukas Krejci 2010-07-28 07:36:27 UTC
Hmm, I find some of the wording slightly confusing:

Instead of 

"These names are expanded when the same types of resources are
available on multiple hosts or have multiple instances on the same host to
provide additional identifiers while still keeping the name concise."

I'd write something along the lines of:

"Search results and other resource lists throughout the whole UI were augmented to better distinguish between colliding names by providing the full paths to the resources. That way you always get an idea where a resource is located (what machine, under which server, etc.)."

Instead of:

"This makes resource names clearer and more user-friendly, while making the resource tree navigation easier to read and use."

I'd say:

"This helps user navigate through the search results more easily. The resource tree uses these new names as well and was enhanced to better convey the types of the resources being shown making it more concise and easier to navigate through."

Of course, change these as you see fit to sound better in English, but I think this would better describe the changes that were made.

Comment 7 Mike Foley 2011-04-21 18:53:22 UTC
Verified the release notes contains the information.

Comment 8 Corey Welton 2011-05-24 01:07:50 UTC
Bookkeeping - closing bug - fixed in recent release.