WHEN I am typing the arguments to a function
THEN I should see the function signature
AND I should see the type of the argument which I am currently typing

When typing an opening bracket, VS Code shows an awesome popup with information about all function signatures. As you continue typing arguments, it scopes the popup down to the signatures that match the arguments that have already been entered. It also highlights the definition of the current argument that is being typed. E.g.

We should do something similar!

This would be extra helpful for when we don't have any suggestions for a particular parameter but we still know its type.

Here we have nothing to suggest for the second parameter of auto_bucket but we know it has to be a number. We don't communicate this to the user though...

Extra credit

In VS Code (Typescript), it also shows a parameter description when available.

The definitions provided by Elasticsearch sometimes include these but right now we have nowhere to show them in the UI. If we built a similar experience to VS Code, we could totally wire this up after #179634!