add more documentation, small tweaks on main README.md