OMG i found this site on this forums... seriously THIS should be the front page to the current dev page.
https://moodle.github.io/devdocs/docs/guides/javascript
https://moodle.github.io/devdocs/docs/guides/javascript