Documentation Requests/Feedback

User avatar
krzychb
Posts: 227
Joined: Sat Oct 01, 2016 9:05 am
Contact:

Re: Documentation Requests/Feedback

Postby krzychb » Thu Jul 04, 2019 5:57 am

Mr_Red wrote:
Mon May 13, 2019 12:53 pm
I'm getting "Page does not exist yet" error when trying to access the following versions of IDF doc (from the drop-down menu or from the release notes):
https://docs.espressif.com/projects/esp ... 3.3-beta3/
https://docs.espressif.com/projects/esp-idf/en/v3.1.4/
Hi @Mr_Red,

Thank you for pointing out this issue and sorry for problem with accessing documentation for these releases.
Before a new release and tag is published, you can resort to using release branch tags that have been made visible instead:

* release-v3.3
* release-v3.1

The release branch links contain the latest updates pushed to the repository for specific release.

Mr_Red
Posts: 11
Joined: Mon Sep 11, 2017 12:41 pm

Re: Documentation Requests/Feedback

Postby Mr_Red » Thu Jul 04, 2019 2:55 pm

krzychb wrote:
Thu Jul 04, 2019 5:57 am
Hi @Mr_Red,

Thank you for pointing out this issue and sorry for problem with accessing documentation for these releases.
Before a new release and tag is published, you can resort to using release branch tags that have been made visible instead:

* release-v3.3
* release-v3.1

The release branch links contain the latest updates pushed to the repository for specific release.
@krzychb,

It would be great if the doc would show the IDF version on the index page. For example, if I go to the stable version doc, I don't see a quick way of knowing which IDF version it applies to. Also, does release-v3.1 apply to the last release tag (3.1.4) or the current state of the release-v3.1 branch?

User avatar
krzychb
Posts: 227
Joined: Sat Oct 01, 2016 9:05 am
Contact:

Re: Documentation Requests/Feedback

Postby krzychb » Sun Jul 14, 2019 4:14 am

Hi @Mr_Red,

You are right, for “stable” release the specific version number is not immediately visible. It may be checked by clicking Get Started.

Answering you other question, "release-v3.1" shows the current state (latest commits) of the release/v3.1 branch.

To summarize on documentation available for specific ESP-IDF versions:

The IDF version is shown in upper left corner below Espressif's logo. Depending on what version is selected from a menu in bottom left corner (see ESP-IDF Versions), this will be:

* latest - for the current (latest) updates on master branch, this is also default selection when first opening https://docs.espressif.com/projects/esp-idf/ page
* stable - for current stable release (go to Get Started to see the specific version number)
* vN.M.K - for specific version number, e.g. v3.1.3
* release-vN.M - for the current updates on specific branch, e.g. "release-v3.1" shows the current state of the release/v3.1 branch,
* some-branch-name - for the current state on some other branches, e.g. "feature-esp32s2beta" show the current state of "feature/esp32s2beta" branch prepared for beta testers of the ESP32-S2 Beta chip

Who is online

Users browsing this forum: No registered users and 1 guest