docs($q): add more detail and examples on chaining promises

Add examples on two ways of adding to chains of promises. The existing section mentions chaining,
but gives only a basic example and doesn't explain the different ways to defer resolution.