I thought the example I provided, where you want to pipe some multi-line input data through a function, and compare the result to an expected set of multi-line output data, is a fairly realistic example of where stacking heredocs might be used. I won't claim to use stacked heredocs on a frequent basis, but I have used them from time to time, and have seen them used by others.

I use it in this test file for example: