The plugin documentation needs some work. Specifically the maven, project report, and custom plugin sections are really lacking. These are things that people are using and you either have to comb through the code or find examples somewhere of how to use them. As gradle starts to mature more and more people will be wanting to create plugins and there's no official place to go to find out how to create them. This is needed in the docs.