update sh with more comments