Add real world examples to documentation

[joeyfigaro]

Would help gain complete understanding of how to put this to good use.

[MrSwitch]

Here's a real world example

https://github.com/MrSwitch/tricks/blob/d65e63be17de9166e668d0195669f6bfea27ba80/package.json#L92-L120

• it took a few attempts (refer to the file history for all the previous wrong turns)

[BeyondEvil]

Including YAML please.