Modifications to README.md to describe software.
Added clarification in README.md and added sample files in docs.