Add some hopefully useful documentation for people creating new interfaces

The generated classes don't really have documentation for the generated methods. This hopes to provide some context.

Given it's developer documentation and therefore frightfully boring feel free to just edit the branch directly.