updated readme; transitions should avoid side effects.
Merge branch 'performance' into develop