[PR] docs: update 2.1 listener port guidance [apisix-ingress-controller]

["kayx23 (via GitHub)" <gi...@apache.org>]

kayx23 opened a new pull request, #2786:
URL: https://github.com/apache/apisix-ingress-controller/pull/2786

   ### What this PR does
   
   Updates the latest docs to match APISIX Ingress Controller 2.1.0 listener-port behavior:
   
   - Replaces stale Gateway listener `port` guidance that said the port is required but ignored.
   - Links `listener_port_match_mode` from Gateway setup examples and the configuration reference example.
   - Adds troubleshooting guidance for Gateway API HTTPRoute/GRPCRoute `404` responses when Gateway listener ports differ from APISIX data-plane ports.
   - Updates the getting-started httpbin example URL from the `v2.0.0` branch to the `v2.1.0` branch.
   
   ### Why
   
   In 2.1.0, port-based routing for Gateway API routes can inject `server_port` route vars based on Gateway listener ports. The docs already document this in the Gateway API concept page and configuration reference, but several getting-started pages still said the listener port was ignored.
   
   ### Validation
   
   - `git diff --check`
   - `npx --yes markdownlint-cli@0.36.0 <changed files>`
   - `npx --yes markdown-link-check@3.13.6 <changed files>` checked local changed links successfully. Existing external `https://httpbin.org` links currently return `503` in three changed files and are unrelated to this PR.
   
   I also scanned `docs/en/latest` for explicit RC/release-candidate language and stale listener-port wording; no such docs text remains after this update.
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

Re: [PR] docs: update 2.1.0 listener port guidance [apisix-ingress-controller]

["kayx23 (via GitHub)" <gi...@apache.org>]

kayx23 merged PR #2786:
URL: https://github.com/apache/apisix-ingress-controller/pull/2786


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org