updated README.md
added explaination for samples
fixed type errors
updated the doc