To be clear: this is for all inputBinding fields? Or only specific examples/use cases?

Yes, for everything except arrays it is clearer or simpler to use the arguments style

It will be a bit awkward when it comes time to explain arrays, but I think it is worth it.

ok, this calls for a bigger PR then. Hope to have time in coming days.

@kinow - Did you do this already for the examples or do we need to do this still. If so, this might be a starting ticket since it is pretty straightforward.

I think there was one place I did that, but I think it was in the new examples. But I didn't go through the rest of the user guide to see what else could be updated. That's still pending 👍