Ok, my point is that I would prefer it if they weren't in the source code. I think usage examples would fit in better in a "how to use the services" section of the documentation, that was written outside of the source code. I know that not everyone agrees and that is fine too, this is absolutely only a suggestions, but I prefer a leaner source code.

Especially in the method doc strings I think it would be better to simply give an example of the arguments, instead of how they are used, I mean, those first two lines of code in all examples about how to instantiate a SoCo object, should and is served with in introduction.