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