Add comments and documentation for regression tests and tracking assets

[clmould]

Need to better document our regression testing and tracking assets. Eg, at what point are the regression assets updated, and where in the code does this happen? Perhaps some comments in the yml file, and more info in the regression section of the docs