Documentation Improvements

Preview:
http://www.stsci.edu/~lbradley/photutils/
This shows up verbatim in the HTML:
```
.. doctest-requires:: skimage
```