Bug 742623

Summary:	Improve docs on compatible/mixed group descriptions
Product:	[Other] RHQ Project	Reporter:	Deon Ballard <dlackey>
Component:	Documentation	Assignee:	Deon Ballard <dlackey>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Mike Foley <mfoley>
Severity:	unspecified	Docs Contact:
Priority:	medium
Version:	4.1	CC:	dlackey, hrupp, rbuck
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:	742520	Environment:
Last Closed:	2012-06-29 01:10:28 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:	742520
Bug Blocks:

Description Deon Ballard 2011-09-30 19:36:08 UTC

+++ This bug was initially created as a clone of Bug #742520 +++

Go to Inventory, then click on compatible group and then on "New". Enter a name, then select resources.
Select all resources and finish. See the list of compatible groups on the next step not having the compatible group listed, as by adding all resources, a mixed group has been created.

While on one hand it is good to be a little bit more flexible than before, this also may result in a confused user.

We should 
- add a descriptive blurb on page 1 of the group creation wizard, that explains comp. vs mixed groups
- add a section in the docs
- re-think if we need the individual entries on the inventory tab for comp/mixed groups, as one may just create compatible +mixed groups on the "all groups" entry.

--- Additional comment from hrupp on 2011-09-30 15:32:36 EDT ---

http://docs.redhat.com/docs/en-US/JBoss_Operations_Network/3.0/html/Basic_Admin_Guide/sect-Basic_Admin_Guide-Managing_Groups-Defining_Groups.html 

does not talk about how a user can create a comp / mixed group.

In the old UI, this was explicitly chosen by the user.

Comment 1 Deon Ballard 2011-11-28 16:30:46 UTC

I have an overview that compares compatible and mixed groups (based on a section on the RHQ wiki):
http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Operations_Network/3.0/html/Initial_Setup_Inventory_Groups_and_Users/managing-groups.html#managing-groups-info

It's short.

And then the creating groups section talks about compat v mized groups:
http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Operations_Network/3.0/html/Initial_Setup_Inventory_Groups_and_Users/sect-Basic_Admin_Guide-Managing_Groups-Defining_Groups.html

Comment 2 Robert Buck 2011-11-28 21:44:13 UTC

Verified. Two tweaks:

a. /dictates/specifies
b. /andmixed/and mixed/

Deon fixed this already via direct conversation.