I think for most of us it works exactly as we suppose.
Some years ago there was no exact documentation available, so indeed you request writing documentation. But I think explaining this is not that easy, as it should be understandable to newcomers, but at the same time not boring for experts. Maybe you can try yourself, and araq or mratsim can correct it. But maybe we need two version, the short for the manual, and the longer one for a beginner book.
