But look at it from the other side. Users that don't read your documentation and expect your software to work like they imagined are just a huge pain in the ass.
This case is different as breakage probably affected github/microsoft themselves
You minimally read the docs, get something working and then leave it alone. Of course you're going to be pissed off when an implicit assumption which has been stable for a long time is broken.
This accurately describes my beef with golang
Microsoft was once renown for bug-compatibility so as not to break their users. The new wave of movers and breakers would forget that wisdom at their peril.