Customizing the docstring view in VSCode

[thomasaarholt]

We can inspect docstrings using Cmd + Shift + Space in VSCode. For docstrings with arguments with only a single type, these look great:

For docstrings with many arguments where each argument has several possible types, it is a lot more noisy:

The main problem is that it is hard for my eyes to parse what is a new argument and what is a type I'm just unfamiliar with.

Does there exist any ways to customise this view?

Some suggestions if there does not:

For instance, changing defaults to having each argument on its own row, possibly swapping between views by using a combination of keys - for instance double tapping Cmd + Shift + Space.

Alternatively press a button combination to step through the possible arguments in order to highlight each one.

[brettcannon]

That view is provided by either Pylance or Jedi, and so they would be the ones controlling how that looks. If you're using Pylance, would you mind opening a feature request at https://github.com/microsoft/pylance-release/issues?

[thomasaarholt]

Thanks for the answer! Yeah, using Pylance, but wasn't quite sure where to go, although going directly to pylance makes sense in retrospect!

[brettcannon]

And I do believe the highlight changes as you type arguments. You're also unfortunately using pandas which has notoriously complex types (took the Pylance team quite a while to write them!).

[thomasaarholt]

I may have purposefully chosen Pandas to highlight the challenge 😅 but I do come across this often :) The highlighting is really nice - that's what inspired my idea of "tapping" through them using some sort of key.