Updating documentation of MGC write_test_script function

We have a helper function, write_test_script, that needed a little extra documentation. Adding that here, and doing a tiny bit of tidying as I go.