Red Hat Satellite engineering is moving the tracking of its product development work on Satellite to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "Satellite project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs will be migrated starting at the end of May. If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "Satellite project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/SAT-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.
Bug 1308648 - docs should describe roles creation in greater depth
Summary: docs should describe roles creation in greater depth
Keywords:
Status: CLOSED NOTABUG
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Documentation
Version: 6.1.6
Hardware: All
OS: All
medium
medium
Target Milestone: Unspecified
Assignee: satellite-doc-list
QA Contact: satellite-doc-list
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-02-15 16:50 UTC by Patrick C. F. Ernzer
Modified: 2019-10-24 17:22 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-10-24 17:22:56 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Patrick C. F. Ernzer 2016-02-15 16:50:31 UTC
Description of problem:
Sat 6.1 docs are not describing how to create your own roles in sufficient depth.
Section "17.3. Creating and Managing Roles" describes the obvious webUI things (Click New Role, Click Submit to save your new role, etc) but is lacking details on what each permission does.
When looking in the webUI; most are close to obvious, but the Sat 6 docs really should describe them all, so that users have a canonical reference they can turn to.

Version-Release number of selected component (if applicable):
6.1

How reproducible:
always

Steps to Reproduce:
1. try to create your own role in Sat6
2. RTFM at Chapter 17 of the Sat 6.1 User Guide


Actual results:
webUI buttons are described in great depth.
permissions sadly not.

Expected results:
all permissions are explained in the documentation.
I guess starting from the output of
Procedure 17.11. To Create a Complete Permission Table

Additional info:


Document URL: 
https://access.redhat.com/documentation/en-US/Red_Hat_Satellite/6.1/html/User_Guide/sect-Red_Hat_Satellite-User_Guide-Users_and_Roles-Creating_and_Managing_Roles.html

Section Number and Name: 
17.3. Creating and Managing Roles

Describe the issue: 

Suggestions for improvement: 

Additional information:

Comment 2 Andrew Dahms 2017-06-13 05:58:35 UTC
Assigning to Zac for review.

Zac - looks like there is some content in the upstream Foreman documentation we can use as the basis for doing some of this work -

https://www.theforeman.org/manuals/1.15/index.html#4.1.2RolesandPermissions

This content now lives in Chapter 4. of the Server Administration Guide in the 6.2 suite.

Comment 3 Andrew Dahms 2017-07-10 04:22:02 UTC
Due to the need to focus on more recent versions of the documentation, and the recent change in focus to producing content for the Satellite 6.3, I am updating the release flags on this bug.

Comment 5 Andrew Dahms 2017-08-17 09:20:26 UTC
Hi Zac,

Thank you for raising this needinfo request.

Because we have now discussed this issue via email, and because the needinfo request has served its purpose of bringing this bug to my attention, I am now clearing this request.

Let me know if you need any further details.

Kind regards,

Andrew


Note You need to log in before you can comment on or make changes to this bug.