docs: add call condition note for TSUrlHostGet

[mmustafasenoglu]

Summary

Add a note to the TSUrlHostGet documentation indicating that it should only be called after TS_HTTP_POST_REMAP_HOOK.

Changes

• Added a note explaining that TSUrlHostGet should only be called after TS_HTTP_POST_REMAP_HOOK
• For earlier hooks like TS_HTTP_READ_REQUEST_HDR_HOOK, TSHttpHdrHostGet should be used instead

Why

Without this note, developers may try to use TSUrlHostGet in hook phases where it won't work correctly, leading to unexpected behavior.

Fixes #5742

[mmustafasenoglu]

Hello! This is my first contribution to Apache Traffic Server. Could you please trigger CI for this documentation PR? Thank you!

[JosiahWI]

[approve ci]

[JosiahWI]

@bneradt The Docs job failed due to warnings (warnings are treated as errors), but the warnings I found were related to env files. I'm not sure what the issue was. Could you take a look?

[bneradt]

From the docs build:

reading sources... [100%] release-notes/whats-new.en
/home/jenkins/workspace/Github_Builds/docs/src/doc/developer-guide/api/functions/TSUrlHostGet.en.rst:77: ERROR: Unknown interpreted text role "data". [docutils]
/home/jenkins/workspace/Github_Builds/docs/src/doc/developer-guide/api/functions/TSUrlHostGet.en.rst:77: ERROR: Unknown interpreted text role "data". [docutils]
looking for now-outdated files... none found
...
copying images... [100%] release-notes/images/roadmap.png
dumping search index in English (code: en)... done
dumping object inventory... done
build finished with problems, 2 warnings (with warnings treated as errors).
ninja: build stopped: subcommand failed.

[mmustafasenoglu]

Hi, just checking in on this docs PR. It adds a call condition note for TSUrlHostGet. Would appreciate a review when you have time. Thanks!

[bneradt]

Hi, just checking in on this docs PR. It adds a call condition note for TSUrlHostGet. Would appreciate a review when you have time. Thanks!

Thank you for contributing, however you likely won't get a review until the docs build passes. Please see my previous comment showing the failure output.

[mmustafasenoglu]

Hi @bneradt, I've fixed the :data role error by replacing it with double backticks for the hook names. Could you please trigger CI again? Thanks!

[JosiahWI]

@mmustafasenoglu Once you are authorized to start Jenkins jobs (@bneradt added you to the whitelist) they will start automatically when you open a PR or push to it.