My point was that we should try explaining the reasons and the fix
both concisely and completely, such that there would be no reason to
read about the details, none at all.  IOW, PROBLEMS should be
self-contained.