Page 1 of 1

Version links broken on 'latest'

Posted: Thu Feb 06, 2020 12:28 am
by boarchuz
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.

Re: Version links broken on 'latest'

Posted: Thu Feb 06, 2020 2:18 am
by ESP_Angus
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.

Re: Version links broken on 'latest'

Posted: Thu May 07, 2020 3:28 pm
by boarchuz
ESP_Angus wrote:
Thu Feb 06, 2020 2:18 am
Please let us know if you see any more problems.
"View page source" links are broken throughout latest
eg. https://docs.espressif.com/projects/esp ... index.html currently links to https://docs.espressif.com/projects/esp ... ig.rst.txt instead of the expected github.com/...

Also the Sphinx "theme" link in the footer is broken.

Re: Version links broken on 'latest'

Posted: Thu May 07, 2020 3:43 pm
by boarchuz
Doc for esp_https_ota_get_image_len_read (https://docs.espressif.com/projects/esp ... a_handle_t) isn't generated.

Re: Version links broken on 'latest'

Posted: Thu May 07, 2020 7:27 pm
by ESP_krzychb
Hi boarchuz,

A fix to broken link to "View page source" should be soon pushed to GitHub.
I will follow up on the the other issues.

Thank you for pointing all these issues!

Re: Version links broken on 'latest'

Posted: Mon Jun 15, 2020 1:49 pm
by boarchuz
TRM link in docs is broken: IDF_TARGET_TRM_URL is not replaced with the actual url.

In the Introduction here: https://docs.espressif.com/projects/esp ... h_pad.html

Re: Version links broken on 'latest'

Posted: Mon Jun 15, 2020 2:05 pm
by chegewara
Sorry, i dont want to hijack this topic, but there is more broken links on github:
- 1st link in this readme:
https://github.com/espressif/esp-idf/bl ... /README.md
- 1st link here:
https://github.com/espressif/esp-idf/bl ... e-analysis

I cant find one readme where is about 10 links to https://docs.espressif.com/projects/esp ... index.html API and all broken.

Re: Version links broken on 'latest'

Posted: Mon Jun 15, 2020 4:57 pm
by ESP_krzychb
Hi boarchuz,

Thank you for being patient with us. I will fix this one as well.

Hi chegewara,

We do not have automatic testing of links of readme files in https://github.com/espressif/esp-idf/tr ... r/examples but will get to this one as well. Thank you for hijacking this topic. I am always happy to hear from you :)