updating read me, and adding back missing comments