more comments and documentation for the example scripts