updated official scripts with notes