updates to the readme
add a detailed example page