DOC: docstring examples

Let me know if you see any things you dislike systematically.  I'm trying to keep the number of lines per example small. The linear model ones are a tougher.