Red Hat Bugzilla – Bug 1308648
docs should describe roles creation in greater depth
Last modified: 2018-06-05 02:37:15 EDT
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):
Steps to Reproduce:
1. try to create your own role in Sat6
2. RTFM at Chapter 17 of the Sat 6.1 User Guide
webUI buttons are described in great depth.
permissions sadly not.
all permissions are explained in the documentation.
I guess starting from the output of
Procedure 17.11. To Create a Complete Permission Table
Section Number and Name:
17.3. Creating and Managing Roles
Describe the issue:
Suggestions for improvement:
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 -
This content now lives in Chapter 4. of the Server Administration Guide in the 6.2 suite.
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.
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.