Description of problem: Trying to follow the docs to set up a Foreman instance and use that to provision an OpenStack environment, when I hit this section, I had no idea what I needed to do, or if I even needed to do anything here before carrying on with the install. The chapter opens: "4.3. Editing Host Groups Foreman allows users to override the parameters that will be used when adding new hosts to a host group. In particular the host groups contain parameters for manipulating the passwords that will be used for a variety of user and service accounts that will be created on hosts that Foreman manages." and after that has in an important block: "It is highly recommended that users edit the value of the admin_password configuration key in the OpenStack Controller host group. This configuration key determines the password to be used when logging into the OpenStack dashboard as the admin user." Beyond that, the process flow describes how one might change something, and then proceeds to detail each and every value you might change. It would have been a huge help to me if it had pointed out values that are more commonly changed, or recommended some that I double check, or even just tell me that in most cases the default values are fine and you only need to change them in scenarios where you're doing X. Currently, the section makes me think I have to do something here, but then doesn't help me understand what I need to do. I read this section a bunch of times, skimmed the tables for anything that sounded important a few times, and finally gave up and moved on, hoping that I didn't need to actually change anything here to just get a basic OpenStack environment stood up... Version-Release number of selected component (if applicable): current Additional info:
Assigning to Scott Radvan (author assigned to Foreman content).
Link to Relevant Section ------------------------ https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/4/html-single/Installation_and_Configuration_Guide/index.html#sect-Editing_Host_Groups
Checked in Red_Hat_Enterprise_Linux_OpenStack_Platform-Installation_and_Configuration_Guide-4-en-US-4-87. More detail has been added to each of the tables to outline that they list the core parameters only, and a note has also been added about the nature of the preset parameters being the defaults and suitable for most deployments. Moving to VERIFIED.