Compile notebooks as documentation?

[dhuppenkothen]

I've seen notebooks compiled as documentation in a few places recently (e.g. here). This might be a useful thing to do for Stingray, make sure we don't duplicate work (writing both the notebooks and then basically the same again in the docs) and fix one of the comments by the astropy people (that we currently only have fairly barebones API docs).

Comments? Thoughts?