I understand that you want to provide a client sdk beside your documentation. I wasn't trying to debate that; what I was trying to say is that nowadays you have a lot of tools that generate the sdk client and if you really need changes, you can make them on the generated code. I see no reason to create "by hand" the sdk from scratch. It sounds like, reinventing the wheel.