The quality of the examples is very important.
A collection of good examples can replace an incomplete documentation.
But each example should be short, only in this way it will be eloquent.
The reader is making an effort to understand a concept. Not to debug a procedure!