- improved readme and some documentation
- small readme fix