add example output to readme, and a notes section