remove shadowing and add to readme