disallow_transfer_to_parent is confusing

[vinithbudde-gif]

Describe the bug

disallow_transfer_to_parent is confusing

Expected behavior

Per its naming it should disallow transfer to parent when its True. But, its contradictory based on below attached screenshots (First 3). Per last screenshot, this flag is mentioned in documentation but doesn't have an explanation.

Screenshots

Versions

• OS: [e.g. Windows, Mac, Linux]
• ADK version:
• Python version:

Additional context

Add any other context about the problem here.

[chungFTF]

Here's the definition of disallow_transfer_to_parent

Disallows LLM-controlled transferring to the parent agent.
NOTE: Setting this as True also prevents this agent from continuing to reply to the end-user, and will transfer control back to the parent agent in the next turn. This behavior prevents one-way transfer, in which end-user may be stuck with one agent that cannot transfer to other agents in the agent tree.

I couldn’t find a clear explanation in the ADK docs either. But after adding this to my code, the description finally showed up. Hope it helps you.

Also you can find the definition here