The docs should start with that with a very clean explanation how it works. Basically first paragraph. :)

Otherwise you should expect churn.

But also it should really go into some detail how is this different from tool calls with type enforcement on expected parameters.