update script comments and layout