Documentation: Give more examples of how to use List

[jkimbo]

The section on lists gives a very basic example of creating a list of strings and moves on. As a developer, I know I'm going to be using lists all the time and most likely I would want to be returning a list of other objects. So the documentations should answer:

• What's the best way to return other objects in my resolver function?
• How much does the parent object need to know about the child object?
• What if an object is returning a list of itself (user returning users)?