Documentation: Give more examples of how to use List

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)?