Examples right here might be a bit unwieldy. Philosophically I'm not sure that docs should try to provide motivation :)

That said, here is why I decorate tests in make_tests - I construct them in a generic place A and then run them here where I know that I want to transform them with e.g. DecorateTestCaseResult.