major fixes to the documentation
fix title
updated the README