Merge branch 'docs/minimal_build_migration_v5.5' into 'release/v5.5'

docs(migration): add note about MINIMAL_BUILD to 5.5 migration guide (v5.5)

See merge request espressif/esp-idf!42560

Author: dobairoland

docs/en/api-guides/build-system.rst

@@ -605,6 +605,7 @@ To avoid duplication, every component automatically requires some "common" IDF c
 
 The list of common components is: cxx, newlib, freertos, esp_hw_support, heap, log, soc, hal, esp_rom, esp_common, esp_system, xtensa/riscv.
 
+.. _including-components-in-the-build:
 
 Including Components in the Build
 ---------------------------------

docs/en/migration-guides/release-5.x/5.5/build-system.rst

@@ -0,0 +1,11 @@
+Build System
+============
+
+:link_to_translation:`zh_CN:[中文]`
+
+Examples Built with MINIMAL_BUILD Property Enabled
+--------------------------------------------------
+
+Most of the examples in ESP-IDF are now being built with the ``MINIMAL_BUILD`` property enabled in their project ``CMakeLists.txt`` by using ``idf_build_set_property(MINIMAL_BUILD ON)``. This reduces the build time by including only the ``main`` component and its transitive dependencies.
+
+As a side effect, only these components appear in menuconfig, as noted in the ``Components config`` menu. With ``MINIMAL_BUILD`` enabled, to make other components visible and compiled, add them as dependencies of the ``main`` component dependency or as its transitive dependencies. For more information, please see :ref:`Including Components in the Build <including-components-in-the-build>`.

docs/en/migration-guides/release-5.x/5.5/index.rst

@@ -6,6 +6,7 @@ Migration from 5.4 to 5.5
 .. toctree::
     :maxdepth: 1
 
+    build-system
     security
     system
     peripherals

docs/zh_CN/api-guides/build-system.rst

@@ -605,6 +605,7 @@ Spark Plug 组件
 
 通用组件包括：cxx、newlib、freertos、esp_hw_support、heap、log、soc、hal、esp_rom、esp_common、esp_system。
 
+.. _including-components-in-the-build:
 
 在构建中导入组件
 -----------------

docs/zh_CN/migration-guides/release-5.x/5.5/build-system.rst

@@ -0,0 +1,11 @@
+构建系统
+========
+
+:link_to_translation:`en:[English]`
+
+启用 MINIMAL_BUILD 属性的示例
+------------------------------------
+
+目前 ESP-IDF 中的大多数示例均已在其项目的 ``CMakeLists.txt`` 中通过 ``idf_build_set_property(MINIMAL_BUILD ON)`` 启用 ``MINIMAL_BUILD`` 属性。通过仅将 ``main`` 组件及其传递依赖项包含在构建中，缩短了示例的构建时间。
+
+带来的影响是：如 ``Components config`` 菜单中所述，只有这些组件会出现在 menuconfig 中。启用 ``MINIMAL_BUILD`` 后，若要使其他组件在 menuconfig 中可见并参与编译，需将其添加为 ``main`` 组件的依赖项或传递依赖项。更多信息请参阅 :ref:`在构建中导入组件 <including-components-in-the-build>`。

docs/zh_CN/migration-guides/release-5.x/5.5/index.rst

@@ -6,6 +6,7 @@
 .. toctree::
     :maxdepth: 1
 
+    build-system
     security
     system
     peripherals