Example though is a bit different from extra docs - it is executable code. When the example is small enough that it can be copy-pasted then you can just put it whole into the docs, but when it is too big or comprises of many files copy-pasting it is much more inconvenient.