commenting the examples files and linking the README to the examples