This was well talked about in Hyrums Law, which came from a Googler as well.

https://www.hyrumslaw.com/

> With a sufficient number of users of an API, it does not matter what you promise in the contract: all observable behaviors of your system will be depended on by somebody.

I believe it.

I also believe an off the shelf example of how to use the library correctly will save everyone a lot of pain later.