This pull request just exists to have a place to put comments.  Please don't pull!

Okay.  If you can make the script self-documenting, you could just reference it from the README and avoid having to keep the two in sync.