[ckan-dev] Moving from readthedocs to self hosting?

[Sean Hammond]

CKAN's autodoc-generated docs for the extensions API and the CKAN API
are still missing from docs.ckan.org. They build fine locally (I just
tested on a fresh Ubuntu 10.04 VM), but on readthedocs we're getting
this KeyError;

http://readthedocs.org/builds/ckan/166559/

This looks to me like a problem on their end, but maybe someone else
will see something I didn't.

Last time we had a problem like this I got someone from rtd to fix the
problem on their server. This time it's been a week and I haven't been
able to get a response from them on their IRC channel or mailing list.

I'd like to get these docs fixed before 1.7.1 goes out. Maybe someone
from rtd will get back to me in time. If not, possible solutions:

- Move temporarily to somewhere self-hosted, and let rtd know we've had
  to do this
- Move permanently to somewhere self-hosted
- Stay on rtd but insert a line into the docs that says something like
  'autodoc sometimes fails on readthedocs, if you don't see API docs
  below then find them [in the source code]' with a link to the relevant
  source files on github, and keep trying to get rtd to fix the problem

If we go with self-hosting we should be able to get jenkins to build the
docs automatically when new commits are pushed to github and push the
html to a server.