OCPBUGS-91952: Clarify GWAPI configuration requirements and correct example syntax

[jab-rh]

Align assembly intro and path-based routing title with user tasks, drop an incorrect cluster-admin prerequisite, remove the RegularExpression implementation note, and stop listing re-encrypt TLS as routes-only.

• Ports the enterprise-4.21 fix from cf93e21 to main after the module rename (nw-ingress-gateway-api-deployment-topologies.adoc → gateway-api-deployment-topologies.adoc).
• Corrects Gateway hostname wildcards (*.example.com), broken YAML indentation (broken-bar characters), and HTTPRoute apiVersion values.

Version(s): 4.20+ TBD

Issue:

https://redhat.atlassian.net/browse/OCPBUGS-87011

Link to docs preview:

QE review:

• QE has approved this change.

Additional information:

Refs #113967.

[openshift-ci-robot]

@jab-rh: This pull request references Jira Issue OCPBUGS-91952, which is invalid:

• expected the sub-task to target the "5.0.0" version, but no target version was set
• expected the bug to be in one of the following states: NEW, ASSIGNED, POST, but it is MODIFIED instead

Comment /jira refresh to re-evaluate validity if changes to the Jira bug are made, or edit the title of this pull request to link to a different bug.

The bug has been updated to refer to the pull request using the external bug tracker.

Details

In response to this:

Summary

• Ports the enterprise-4.21 fix from cf93e21 to main after the module rename (nw-ingress-gateway-api-deployment-topologies.adoc → gateway-api-deployment-topologies.adoc).
• Corrects Gateway hostname wildcards (*.example.com), broken YAML indentation (broken-bar characters), and HTTPRoute apiVersion values.

Test plan

• Confirm examples in modules/gateway-api-deployment-topologies.adoc render valid YAML
• After merge, cherry-pick to enterprise-4.22 and enterprise-5.0

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

[ocpdocs-previewbot]

🤖 Tue Aug 04 17:47:08 - Prow CI generated the docs preview:

https://117251--ocpdocs-pr.netlify.app/openshift-enterprise/latest/networking/ingress_load_balancing/configuring_gateway_api/understand-gateway-api.html

[openshift-ci]

@jab-rh: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

[jab-rh]

@rhamini3, this change didn't make it into our other branches, but it looks like it is valid for OCP 5 and 4.22 is well.

Can you confirm?

Thanks!

[rhamini3]

@rhamini3, this change didn't make it into our other branches, but it looks like it is valid for OCP 5 and 4.22 is well.

Can you confirm?

Thanks!

yes this is valid for both releases