improved comments & puncher notes