update scripts to match blog post

This largely updates comments