Documentation/readthedocs

[arokem]

Several issues are outstanding, if we are to use RTD as a documentation hosting service:

What is the best way to create documentation of the API?

This is currently using scripts that I cribbed from nipy projects, and then ported to be compatible with python 3. These scripts require having the software installed on the machine, and are triggered upon running a make html. RTD uses sphinx-build directly (I think), so it's not obvious how this would patch into the process

Latex in documentation

Building documentation with latex on RTD seems to be a no-go, because their system doesn't seem to be able to build/install PIL, which is required. See here: https://readthedocs.org/builds/shablona/2882654/

[arokem]

As pointed out by @rbiswas4, other projects do use RTD, and have API reference machinery set up:

http://sncosmo.readthedocs.org/en/v1.0.x/reference.html

so there must be some way of doing that.

[andim]

See my comment on #26 for a way to create api reference using read the docs. In short you can execute your build script directly from conf.py (andim/noisyopt@13541ac).

[crypdick]

+1!