Document RHOKP URL setting

[aneta-petrova]

What changes are you introducing?

• Adding a line with the new RHOKP URL setting to the admin settings reference table
• Moving the section on RHOKP to Admin (or Planning)
• Extending the section on RHOKP with information about the new setting

Why are you introducing these changes? (Explanation, links to references, issues, etc.)

RedHatSatellite/foreman_theme_satellite#305 adds the setting.

The changes listed in the "What" part are based on the requirements defined in https://issues.redhat.com/browse/SAT-41491.

Anything else to add? (Considerations, potential downsides, alternative solutions you have explored, etc.)

N/A

Contributor checklists

• I am okay with my commits getting squashed when you merge this PR.
• I am familiar with the contributing guidelines.

Please cherry-pick my commits into:

• Foreman 3.17/Katello 4.19
• Foreman 3.16/Katello 4.18 (Satellite 6.18; orcharhino 7.6)
• Foreman 3.15/Katello 4.17
• Foreman 3.14/Katello 4.16 (Satellite 6.17; orcharhino 7.4; orcharhino 7.5)
• Foreman 3.13/Katello 4.15 (EL9 only)
• Foreman 3.12/Katello 4.14 (Satellite 6.16; orcharhino 7.2 on EL9 only; orcharhino 7.3)
• We do not accept PRs for Foreman older than 3.12.

[github-actions]

The PR preview for 05492dd is available at theforeman-foreman-documentation-preview-pr-4611.surge.sh

The following output files are affected by this PR:

• Administering_Project/index-foremanctl-satellite.html
• Administering_Project/index-satellite.html
• Installing_Server_Disconnected/index-foremanctl-satellite.html
• Installing_Server_Disconnected/index-satellite.html
• Planning_for_Project/index-foremanctl-satellite.html
• Planning_for_Project/index-satellite.html
• Upgrading_Project_Disconnected/index-foremanctl-satellite.html
• Upgrading_Project_Disconnected/index-satellite.html

show diff

show diff as HTML

[aneta-petrova]

Hi @ofedoren, this is where I'm developing documentation for the new RHOKP setting. It's still a draft but already shows the expected nature and extent of the docs update. (No need to review just yet, unless you really want to, because we still need to wait for the couple of open questions in the code PR to be resolved.)

[aneta-petrova]

Hi @Lennonka, would you have time for a quick look at a Planning guide update of mine in return? ;) I'm looking for a place for the RHOKP section somewhere else than in disconnected docs; the solution from ticket reporter was Admin (where the new setting is expected to be documented) but I was thinking Planning might give the RHOKP concept description more visibility.

I'm not looking for a complete review yet (because parts of the text might still change quite a bit based on how the code evolves) but if you have time for a quick review of the placement I propose, that would be awesome.

[aneta-petrova]

@ofedoren I think this is ready for review now. Can you please take a look?

[ofedoren]

Thanks, @aneta-petrova, seems complete and correct to me!

[Lennonka]

My apologies, I missed this earlier. Would be worth checking.