update code details and README