how the hell are we going to find this PR again in 2 years when we need to tweak this puppy?

I don't see what's wrong with adding an example in comment right next to it, but fine