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.