ok little grumpy in the morning... but is this really a merge-breaker? this isn't about documenting change in itself, it's about making the user aware that we're not fully backwards compatible. just trying to be nice, and git history isn't exactly the first place i look at when i encounter a bug like this