From f558730477dce29fdbb7b56772a68d820a732bcb Mon Sep 17 00:00:00 2001
From: Krzysztof <krzysztof@espressif.com>
Date: Wed, 22 Apr 2026 13:35:56 +0800
Subject: [PATCH] fix(docs): Add TOC and subtitles to the list of MCPWM header
 files

---
 docs/en/api-reference/peripherals/mcpwm.rst   | 62 +++++++++++++++++++
 .../zh_CN/api-reference/peripherals/mcpwm.rst | 62 +++++++++++++++++++
 2 files changed, 124 insertions(+)

diff --git a/docs/en/api-reference/peripherals/mcpwm.rst b/docs/en/api-reference/peripherals/mcpwm.rst
index dba2b7fe94d..edb9b9935c5 100644
--- a/docs/en/api-reference/peripherals/mcpwm.rst
+++ b/docs/en/api-reference/peripherals/mcpwm.rst
@@ -1066,15 +1066,77 @@ Application Examples
 API Reference
 -------------
 
+MCPWM APIs are divided into the following sections:
+
+* `Timer API`_
+* `Operator API`_
+* `Comparator API`_
+* `Generator API`_
+* `Fault API`_
+* `Sync API`_
+* `Capture API`_
+* `ETM API`_
+* `Driver Types`_
+* `HAL Types`_
+
+
+Timer API
+^^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_timer.inc
+
+
+Operator API
+^^^^^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_oper.inc
+
+
+Comparator API
+^^^^^^^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_cmpr.inc
+
+
+Generator API
+^^^^^^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_gen.inc
+
+
+Fault API
+^^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_fault.inc
+
+
+Sync API
+^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_sync.inc
+
+
+Capture API
+^^^^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_cap.inc
+
+
+ETM API
+^^^^^^^
+
 .. include-build-file:: inc/mcpwm_etm.inc
+
+
+Driver Types
+^^^^^^^^^^^^
+
 .. include-build-file:: inc/components/esp_driver_mcpwm/include/driver/mcpwm_types.inc
+
+
+HAL Types
+^^^^^^^^^
+
 .. include-build-file:: inc/components/esp_hal_mcpwm/include/hal/mcpwm_types.inc
 
 
diff --git a/docs/zh_CN/api-reference/peripherals/mcpwm.rst b/docs/zh_CN/api-reference/peripherals/mcpwm.rst
index 0a117773129..9930494f023 100644
--- a/docs/zh_CN/api-reference/peripherals/mcpwm.rst
+++ b/docs/zh_CN/api-reference/peripherals/mcpwm.rst
@@ -1066,15 +1066,77 @@ Kconfig 选项
 API 参考
 -------------
 
+MCPWM API 分为以下几部分：
+
+* `定时器 API`_
+* `操作器 API`_
+* `比较器 API`_
+* `生成器 API`_
+* `故障 API`_
+* `同步 API`_
+* `捕获 API`_
+* `ETM API`_
+* `驱动类型`_
+* `HAL 类型`_
+
+
+定时器 API
+^^^^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_timer.inc
+
+
+操作器 API
+^^^^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_oper.inc
+
+
+比较器 API
+^^^^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_cmpr.inc
+
+
+生成器 API
+^^^^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_gen.inc
+
+
+故障 API
+^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_fault.inc
+
+
+同步 API
+^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_sync.inc
+
+
+捕获 API
+^^^^^^^^
+
 .. include-build-file:: inc/mcpwm_cap.inc
+
+
+ETM API
+^^^^^^^
+
 .. include-build-file:: inc/mcpwm_etm.inc
+
+
+驱动类型
+^^^^^^^^
+
 .. include-build-file:: inc/components/esp_driver_mcpwm/include/driver/mcpwm_types.inc
+
+
+HAL 类型
+^^^^^^^^
+
 .. include-build-file:: inc/components/esp_hal_mcpwm/include/hal/mcpwm_types.inc