Would you say this is a case where that explanation should be in the code itself?
It seemed to me that "what it does" was pretty self-evident, and the "why we need it" could be adequately included on the example page. What do you think?