more readme and documentation changes