flatten example
more documentation work
Merge pull request #2 from gclaramunt/refactor

flatten example