I was thinking along similar lines when I ran the script, but to a certain extent it seemed like having helpful examples in the config file would clear up confusion. Nevertheless, I think it's certainly worth writing the process down a little more. I wonder should we instead follow the example of pw_maintainers_cli.py and have the example usage, how to run, etc. written as a string at the top of the file? Then we are consistent with how other scripts in the repo are operating.