Bug 1019681

Summary:	RBAC description in Release Notes incomprehensible
Product:	[JBoss] JBoss Enterprise Application Platform 6	Reporter:	Ladislav Thon <lthon>
Component:	Documentation	Assignee:	Lucas Costi <lcosti>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Ladislav Thon <lthon>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	6.2.0	CC:	jdoyle, lcosti, nziakova
Target Milestone:	GA
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2013-12-15 17:01:54 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:
Embargoed:
Bug Depends On:
Bug Blocks:	1018743

Description Ladislav Thon 2013-10-16 09:00:52 UTC

I find the RBAC description in Release Notes hard to understand. Here's a bunch of suggestions to make it better:

1. improving access control over management operations -> improving
[granularity of] access control for management operations

- the [granularity of] part is not absolutely necessary, but IMO it makes the description more accurate

- "over" should be changed to "for", I believe (but then, I'm not a native speaker)

2. comment-line interface -> command-line interface

- just a typo

3. "via either the command-line interface (CLI) or management console" -- that's not very precise, it applies to _all_ management interfaces (though CLI and console are the most prominent ones); on the other hand, it's mentioned correctly in the last sentence, so maybe it's not a big deal

4. Group membership is associated with one of several roles -> Users and
user groups can be assigned one of several roles

- can't really understand what the original means

Comment 1 John Doyle 2013-10-16 20:35:43 UTC

Here's a restatement.

Role-based access control (RBAC) has been implemented, improving granularity of access control for management operations through all management interfaces. Users and groups can be associated with one of several roles that determine the level of access to the management operations.

Comment 3 Ladislav Thon 2013-10-17 06:22:37 UTC

This is a lot better, thanks!

Comment 4 Lucas Costi 2013-10-17 06:34:54 UTC

On stage and ready for review (Revision 2.0-2):

http://documentation-devel.engineering.redhat.com/docs/en-US/JBoss_Enterprise_Application_Platform/6-Beta/html-single/6.2.0_Release_Notes/index.html#idp10291776