expand readme file, cleanup comments