ns : added some notes to the top of script