flatten example

more documentation work