script, readme and code book updates