I think there's no documentation about how to write a plugin. Only a template exists, but I guess that's not documentation enough. I also agree that the current documentation it not really straight forward but it's a good starting point. Maybe this can be improved later too. What I was also missing when writing a plugin, is a developer documentation containing how to write it, what can be used, what is the basic structure and how are plugin working, ...

Don't get my suggestions wrong. I only want to tell you my opinion. You're the plugin writer and you can decide if you want to change it or not. It's not a problem to leave it as is, that's all only suggestions you can take care or not ;-)