A sufficiently good VPL should allow the documentation to be as rich/visceral/joyful as a video game.
A favourite example is the editable tutorial patches in Max/MSP, which are mostly a series of whoa! cool! audio effects that are intrinsically fun to play with (and picking up Max/MSP tends to be a thing done by people looking to play with whoa! cool! audio effects). The "tutorial" is, in effect, the encouragement to rip apart those effects and see how they were built. Very constructionist.