update readme example and descriptions