chore(updatecli): Adds documentation to the script and enhances the jq command.

[gounthar]

This is a follow-up PR to #907.

I refined the tag selection logic in jq by implementing a filter for tags containing hyphens.
To enhance code understanding, I added explanatory comments that provide additional context about the data retrieved from the RedHat REST API.

A comprehensive markdown documentation detailing the API's functionality is currently in development and will be included in an upcoming pull request.

Testing done

./updatecli/scripts/ubi9-latest-tag.sh
9.5-1732804088

Submitter checklist

• Make sure you are opening from a topic/feature/bugfix branch (right side) and not your main branch!
• Ensure that the pull request title represents the desired changelog entry
• Please describe what you did
• Link to relevant issues in GitHub or Jira
• Link to relevant pull requests, esp. upstream and downstream changes
• Ensure you have provided tests - that demonstrates feature works or fixes the issue

[dduportal]

Checks says:

✔ Bump UBI9 version:
	Source:
		✔ [latestVersion] Get the latest UBI9 Linux version
	Condition:
		✔ [checkUbi9DockerImage] Check if the container image "ubi9" is available
	Target:
		✔ [updateDockerBake] Update the default value of the variable UBI9_TAG in the docker-bake.hcl
		✔ [updateDockerfile] Update the value of the base image (ARG UBI9_TAG) in the Dockerfile

That looks good to me!

Let's have a secondary review by @lemeurherve as he asked for some of these changes in previous PRs

[lemeurherveCB]

Thanks for the follow-up!

Some suggestions below.

[lemeurherveCB]

Reposting a comment from an automatically hidden thread:

A comprehensive markdown documentation detailing the API's functionality is currently in development and will be included in an upcoming pull request.

remark(not concerning this PR): a doc for RedHat API? If so, I don't think it has a place in this repo as it's not a core part of Jenkins agents, I would suggest not spending time on this.

[lemeurherveCB]

LGTM, thx!