Better documentation of the Cinnamon API

A thing I hate about Cinnamon (as a fairly unexerienced developer in this area) is the lack of an API documentation.

Even the most simple applet becomes hard to create - The only thing I could find was the Force Quit/xkill applet tutorial.

I think this is quite a sad fact, because Cinnamon is continuosly gaining popularity. With such a growing community comes a greater amount of developers.

JavaScript itself is easy to learn, but where am I supposed to learn the Cinnamon-specific stuff? Of course I can try to understand the commands and classes from the given applets, but so I will never learn what every specific command exactly does and I will certainly never know what commands exist.

So I think a complete API documentation for Applets, Desklets and Extensions is crucial for Cinnamon.

I already filed this at community.linuxmint.com, and they asked me to write this here

Start with the existing Force Quit/xkill applet tutorial and review the current documentation for Applets, Desklets, and Extensions. Define the API areas and documentation scope before proceeding; done means developers can find and understand the Cinnamon-specific commands and classes needed to build these components.