Comment by Avshalom

I think well commented examples are the best documentation but they are absolutely not a substitute for traditional docs.