added README and more comments in the yaml samples