Version links broken on 'latest'

boarchuz
Posts: 204
Joined: Tue Aug 21, 2018 5:28 am

Version links broken on 'latest'

Postby boarchuz » Thu Feb 06, 2020 12:28 am

Using the 'Read The Docs' popup menu to select a different version of the IDF docs on any page seems to fall back to the root https://www.espressif.com/en/support/download/documents page.

Take the 'latest' HTTP server page, for example: https://docs.espressif.com/projects/esp ... erver.html
The link to 'release-v3.3' is "https://docs.espressif.com/en/release-v3.3/", which is not only invalid (a valid root url would be https://docs.espressif.com/projects/esp ... ease-v3.3/) but doesn't even try to link to the 'HTTP server' page as expected.

Actually this is a little more complex than I first realised. Perhaps it only affects 'latest'...
Opening https://docs.espressif.com/projects/esp ... erver.html will cause the bug, however opening https://docs.espressif.com/projects/esp ... erver.html is fine (and I can even switch to 'latest' and then to any other version without problems - does the popup menu not reload?).

Oh yeah I see now in the Chromium log, for 'latest' only:

Code: Select all

Error loading Read the Docs footer
error @ readthedocs-doc-embed.js:1
Ironically, the "Submit documentation feedback to us." link on the page it redirects to (https://www.espressif.com/en/support/download/documents) is dead.

ESP_Angus
Posts: 2072
Joined: Sun May 08, 2016 4:11 am

Re: Version links broken on 'latest'

Postby ESP_Angus » Thu Feb 06, 2020 2:18 am

boarchuz wrote:
Thu Feb 06, 2020 12:28 am
Using the 'Read The Docs' popup menu to select a different version of the IDF docs on any page seems to fall back to the root https://www.espressif.com/en/support/download/documents page.
Thanks for letting us know. Because the RTD servers are slow to access from China (and their CDN doesn't have China coverage), we maintain a transparent caching reverse proxy for the ESP-IDF documentation.

In this case it looks like an RTD update changed the API URL, so the proxy stopped working.

This should be fixed now (may require a ignore-caches-reload with Shift-F5 or similar). Please let us know if you see any more problems.
Ironically, the "Submit documentation feedback to us." link on the page it redirects to (https://www.espressif.com/en/support/download/documents) is dead.
Thanks for letting us know about this as well, will get it fixed ASAP.

Who is online

Users browsing this forum: No registered users and 44 guests