[W]hen you have a spec that almost *everyone* ignores or gets wrong[…] it might be time to acknowledge that the problem is the spec instead of the implementors.

David Megginson (emphasis his).