first pass at getting sphinx and automodapi running

[SaOgaz]

not storing automodapi generated docs for now. #51

Things I needed to add to env for this PR:
through "conda install":
stsci_rtd_theme
sphinx_rtd_theme
numpydoc
update conda install of astropy to 3.0 or above

I also had to "pip install sphinx-automodapi"

[SaOgaz]

Removing RTD files. Have been told that RTD has no plans to run on private repos.

[bourque]

Sorry for the delay @SaraOgaz, I'll look at this tomorrow or Friday

[bourque]

@SaraOgaz This is really nice to have! I want to switch all of my other projects to use this 0_0

[bourque]

@SaraOgaz I can add some documentation here, but I will do that in a separate PR.

[bourque]

@SaraOgaz What does this do?

[SaOgaz]

I do not remember changing that.... I will change it back.

[bourque]

Thanks @SaraOgaz, this all looks good. Though I don't think I will merge this until I can properly build the docs locally. Right now I am encountering trouble building the jwqldev environment (and hence the docs) because our dependency on jwst package in astroconda-dev seems broken:

CondaError: MD5MismatchError: Conda detected a mismatch between the expected content and downloaded content
for url 'http://ssb.stsci.edu/astroconda-dev/osx-64/cfitsio-3.440-3.tar.bz2'.
  download saved to: /Users/bourque/anaconda2/pkgs/cfitsio-3.440-3.tar.bz2
  expected md5 sum: 237893ac8e404d775bf72d78d7885b6c
  actual md5 sum: da34db3f1503914ab65ea79cb184e503

[bourque]

@SaraOgaz I was able to build the jwqldev environment and API docs locally without much hassle. The only thing I had to change was the first line of environment.yml from macs name: jwqldev back to name: jwqldev, otherwise I get this error:

(astroconda3) [kramer:jwql] conda env create -f environment.yml
Using Anaconda API: https://api.anaconda.org

SpecNotFound: Can't process without a name

What is the deal with this macs name? What does it do? Is it necessary?

[bourque]

@SaraOgaz I should also mention that I had to add numpydoc_show_class_members = False to avoid WARNING: toctree contains reference to nonexisting document 'api/jwql.preview_image.preview_image.PreviewImage.some_method' warnings. Not sure why or how it works at this moment, but some amount of googling lead me to this solution.

[bourque]

Thanks @SaraOgaz, this looks good and builds on our dev server. There are some warnings dealing with specific docstrings in preview_image.py, but I'll take care of those in a separate PR. I'll also add project documentation in a separate PR.