DOC: docstring examples

Closes #45

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.

still WIP for now.