Problems with the TinyMCE plugin docs about devdocs HOT 2 OPEN

8. Editor configuration - configuration.js - I don't know what that first technicality about Promises is about. Once you get past that, it is confusing that the two examples are not consistent. The first one uses addToolbarButtons and the second getToolbarConfiguration, which is it?

9. Looking at real examples in the code, I find it very unhelpful that the code is atomised into 8 different JS files each with a tiny fragement of code.

10. Is it the case that you should not even try to look at the Moodle docs until you fully understand TinyMCE in isolation? If so, why not say that, with a link to the relevant docs. If not, the I don't know.

from devdocs.

11. It would be good to have some convention in these docs, for when things you mention are part of the core TinyMCE API, vs things that are functions you define in your plugin.

from devdocs.