added script to generate examples/README.md and the new README.md
updated example docstrings and README.md