readme update and smoother transitions