Backport to readme

I brougght back some things you removed to readme so that they'll be keept when I'll merge. 

I'll continue to push other fixes on this branch.