Documentation Improvements

Preview:
http://www.stsci.edu/~lbradley/photutils/
Please no `import *`, not even in hidden plotting code ... users can still click on it and copy & paste it or learn from it.