[dualogy]

The plugin API seems powerful enough but last time I tried to play with it, I didn't get into the groove of things because docs were incomplete/not-up-to-speed/blog-posts-elsewhere-also-often-outdated, all this combined with Python-the-language it felt a bit too fickle/messy to me to get serious --- there was no comparison to the quite brilliant docs at https://code.visualstudio.com/docs/extensionAPI/overview when I weighed my options ---

But now that 3 is out of beta, I'll take another look and once again hope for an exhaustive, complete, up-to-date and comprehensive documentation of plugin development

[kylebebak]

I've found the docs to be complete but lacking in examples.

Examples often say more in 10 lines of code than a page of docs, but I didn't find this to be an issue. To write Requester, I cloned plugins with features I wanted to implement (e.g. GitSavvy) and used them to complement the docs.

I think the docs could be improved with examples of small useful plugins that touch on various areas of the API. This might be a good project for the community.

[kylebebak]

Just to clarify: the docs are rustic but complete. The API itself is immensely powerful.