readme update and some fine tuning for minimizing docs