docs: API reference at python-cerberus.org lacks generated contents

[funkyfuture]

• I consulted these documentations:

  • http://docs.python-cerberus.org/en/stable/
  • http://docs.python-cerberus.org/en/latest/

• I consulted these sections of the docs:

  • API

• I have the capacity to submit a patch when a bug is identified.

---

Bug report

i just noticed that these generated includes of the docs do not appear in the online docs while they do in a local build:

http://docs.python-cerberus.org/en/stable/api.html#error-codes
http://docs.python-cerberus.org/en/stable/api.html#schema-validation-schema

[funkyfuture]

is the checkbox "Install your project inside a virtualenv using setup.py install" checked in the Advanced Settings of the RtD-project? if not and checking it solves the issue, maybe the call to docs/includes/generate.py should be in conf.py rather than in the Makefile to let the build fail if there's a problem.

[nicolaiarocci]

Yes the checkbox is checked now (it wasn't), but it does not seem to solve the issue.

[funkyfuture]

now it also seems to affect builds on travis.

[funkyfuture]

maybe a git-hook that updates the then repo-included assets is the most durable solution?

[nicolaiarocci]

Seems odd to me that only py35 is affected on travis.

[funkyfuture]

that is because the doctests run on it: https://github.com/pyeve/cerberus/blob/master/tox.ini#L36

[funkyfuture]

i pledge to mark this for the 1.2 milestone.