[kyrra]

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.

[mjevans]

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.

[shermantanktop]

I always strongly suggest sample code to people designing new APIs. Can be a very revealing exercise.