diff --git a/docs/en/versions.rst b/docs/en/versions.rst
index cf544a8482..35c6adfe1c 100644
--- a/docs/en/versions.rst
+++ b/docs/en/versions.rst
@@ -43,6 +43,8 @@ Which Version Should I Start With?
 
 - If a required feature is not yet available in a stable release, but you do not want to use the master branch, it is possible to check out a pre-release version or a release branch. It is recommended to start from a stable version and then follow the instructions for :ref:`updating-pre-release` or :ref:`updating-release-branch`.
 
+- If you plan to use another project which is based on ESP-IDF, please check the documentation of that project to determine the version(s) of ESP-IDF it is compatible with.
+
 See :ref:`updating` if you already have a local copy of ESP-IDF and wish to update it.
 
 .. _versioning-scheme:
diff --git a/docs/zh_CN/versions.rst b/docs/zh_CN/versions.rst
index 0d268d946e..a1e508d165 100644
--- a/docs/zh_CN/versions.rst
+++ b/docs/zh_CN/versions.rst
@@ -43,6 +43,8 @@ ESP-IDF 在 GitHub 平台上的完整发布历史请见 `发布说明页面`_。
 
 - 如需使用稳定版本中没有的新特性，但同时又不希望受到 master 分支更新的影响，您可以将一个最适合您的稳定版本 :ref:`更新至一个预发布版本` 或 :ref:`更新至一个发布分支`。
 
+- 如需使用其他基于 ESP-IDF 的项目，请先查看该项目的文档，以确定其兼容的 ESP-IDF 版本。
+
 有关如何更新 ESP-IDF 本地副本的内容，请参考 :ref:`updating` 章节。
 
 .. _versioning-scheme: