document this issue as a "common issues".

I'm not sure entirely how common this is,
as somebody who runs into the issue, this might
be the first place I'd look ..