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.

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