update the how-it-works documentation

[rhs]

The how-it-works documentation suggests that the image name has to be based on the filename. This used to be true, but now it is customizable. There may well be other examples like that as things have come along quite a ways since that doc was written.