Can you add a diagram describing how a module fits into Cider architecture?

Also I would suggest being lean on the module usage section i.e. example uses, and more detailed on how to write the module and what is the significance of each type of resource an author can add to the module. What are those sources provided.

Here we can also consider examples like what will be needed to write a module to:

• Enable an external ide integration.
• Enable an externality auth with a service by installing CLI binary ir injecting some env variable
• Writing some configuration files.
• Install a VSCode extension?

In these we can also link existing matching module implementations as examples.

Okay I had those exact examples in my registry version so I'll clean up and add these to the contributing doc and take into account the rest of your points as well 👌