Read the docs module index broken

[colton-leadpages]

Hey, the link to the module index in RTD is broken:

http://bravado.readthedocs.io/en/latest/py-modindex.html

This is linked to from the docs root:

http://bravado.readthedocs.io/en/latest/index.html

How can I view the API docs for Bravado?

[cdunklau]

I just ran into this. It looks like individual versions after 10.0.1 don't show up on RTD, but the "latest" and "stable" doc versions there have all the way up to 10.4.3 (currently most recent) in the changelog. The API docs do appear in <=10.0.1, and when I build the docs locally with tox -e docs, the API docs do show up in build output... so I suspect an issue with RTD itself or some trouble in the publish process.

@sjaensch I hope you don't mind the ping. I noticed you had the last few release commits, so I imagine you're the right one to poke about this. Any way we can help?

[sjaensch]

I have no clue what's going on there, this must be caused by the work readthedocs have done this year. The versions are still recognized by them, i.e. I see them in the admin. For some reason they're not automatically marked as "active" anymore. I've done so for the latest version (10.4.3). I've also opened a small PR to remove the broken entry from index.rst, we don't really need it.

[cdunklau]

Thanks @sjaensch! It looks like the 10.4.3 docs suffer from the same issue, https://bravado.readthedocs.io/en/v10.4.3/bravado.html only lists the modules, none of the generated API docs like you can see here https://bravado.readthedocs.io/en/v10.0.0/bravado.html

[sjaensch]

Ah good point @cdunklau - I have no idea why that is. I don't think we changed anything related to how we generate our documentation.