update readme following users' feedback