refactor: expand java client limitation documentation

[koevskinikola]

Description

Add examples under what use-cases job long-polling isn't possible with the Java client via the Zeebe
REST API.

closes #4375

When should this change go live?

• This is a bug fix, security concern, or something that needs urgent release support.
• This is already available but undocumented and should be released within a week.
• This on a specific schedule and the assignee will coordinate a release with the DevEx team. (apply hold label or convert to draft PR)
• This is part of a scheduled alpha or minor. (apply alpha or minor label)
• There is no urgency with this change and can be released at any time.

PR Checklist

• My changes are for an already released minor and are in /versioned_docs directory.
• My changes are for the next minor and are in /docs directory (aka /next/).

• My changes require an Engineering review, and I've assigned the Engineering DRI or delegate.
• My changes require a technical writer review, and I've assigned @camunda/tech-writers as a reviewer.

[koevskinikola]

This PR expands the documentation of the Java client limitation from feedback received here.

[conceptualshark]

👍 Thanks for following up on these!

[tmetzke]

👍 Thanks for making this more explicit, @koevskinikola 🚀