Add note about resources searchable by title

[Lennonka]

What changes are you introducing?

Adding a note to global registration for users who need to edit the registration command

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

New feature allows users to search certain resources not only by ID but also by name.
This feature was introduced to ease transition from the bootstrap script to global registration.
Documents theforeman/foreman#10351
SAT-28832 (private)

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

• I couldn't find any better place.
• I think a formal Note is in order to emphasize this info but feel free to disagree.

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: N/A

[github-actions]

The PR preview for 17b594d is available at theforeman-foreman-documentation-preview-pr-3552.surge.sh

The following output files are affected by this PR:

• Managing_Hosts/index-foreman-el.html
• Managing_Hosts/index-katello.html
• Managing_Hosts/index-orcharhino.html
• Managing_Hosts/index-satellite.html
• Provisioning_Hosts/index-satellite.html

show diff

show diff as HTML

[amolpati30]

@Lennonka
I have tested using the following URL fragment, and host registration works as expected:
hostgroup=test1%2Ftest2
location=Default%20Location
operatingsystem=RHEL%209.5
organization=Default%20Organization

[amolpati30]

We can also register a host using the following parameters. Do you think this should be added to the documentation?
location=Default+Location
operatingsystem=RHEL+9.5
organization=Default+Organization

[maximiliankolb]

what's the use case to edit this by hand? Why make users change the way Foreman/Katello searches for resources?
Is the alternative an API endpoint that accepts org/loc/os/host group/ak and returns the registration command?

[Lennonka]

what's the use case to edit this by hand? Why make users change the way Foreman/Katello searches for resources? Is the alternative an API endpoint that accepts org/loc/os/host group/ak and returns the registration command?

@stejskalleos Can you please clarify this?

[stejskalleos]

what's the use case to edit this by hand?

It was a feature request by one of the Foreman users.

[Lennonka]

@stejskalleos @amolpati30 Ack?

[Lennonka]

@maximiliankolb The use case is that one user generates a registration command, edits it and forwards it to other users who run it on hosts, for example, in various locations.
We do not force them to use this feature, we're just giving them the option to use it.

[amolpati30]

Ack from QE 👍

[stejskalleos]

🍏

[maximiliankolb]

ACK; works for me. I was just curious to why users would want this.