Explanation of ESP-IDF branches?

[12pastnoon]

A section about the different versions (and how to choose which version to use) will be added to the IDF Programmers Guide soon (very similar to the advice ESP_Sprite posted, above).

I am new to ESP32 and just cloned esp-idf today. Such documentation will be extremely helpful for new users like me. I was wondering why we are cloning master and not a stable release, and what to do about that.

[kolban]

My loose understanding is that one performs a clone of a repository and then uses the GIT "checkout" command to determine which branch you are going to use.

For example

$ git clone ...
$ git checkout release/3.0

[Angus]

I meant to reply to this post earlier to say thanks for the suggestion.

An explanation of ESP-IDF versions has been added to the docs here:
https://docs.espressif.com/projects/esp ... sions.html

The "Getting Started" guide now includes customised git instructions for the particular version which is being viewed. For example:
https://docs.espressif.com/projects/esp ... et-esp-idf