fix(docs): Apply suggeston(s) from reviewer

Co-authored-by: Zheng Zhong <[email protected]>

Author: leeebo

docs/zh_CN/gettingstarted.rst

@@ -9,21 +9,34 @@
 ESP-IoT-Solution 版本说明
 --------------------------
 
-ESP-IoT-Solution 自 ``release/v2.0``  起采用组件化管理，各组件与示例独立迭代，依赖的 ESP-IDF 版本请查阅组件 ``idf_component.yml`` 文件。release 分支仅维护历史大版本，master 分支持续集成新特性。建议新项目通过组件注册表获取所需组件。
+ESP-IoT-Solution 自 ``release/v2.0`` 起采用组件化管理，各组件与示例独立迭代，依赖的 ESP-IDF 版本请查阅组件 ``idf_component.yml`` 文件。release 分支仅维护历史大版本，master 分支持续集成新特性。建议新项目通过组件注册表获取所需组件。
 
 不同版本说明如下，详情及组件列表请见 `README_CN.md <https://github.com/espressif/esp-iot-solution/blob/master/README_CN.md>`_：
 
-+------------------+------------------+------------------------+----------------+
-| ESP-IoT-Solution |  依赖的 ESP-IDF  |        主要变更        |    支持状态    |
-+==================+==================+========================+================+
-| master           | >= v5.3          | 新芯片支持             | 新功能开发分支 |
-+------------------+------------------+------------------------+----------------+
-| release/v2.0     | <= v5.3, >= v4.4 | 支持组件管理器         | 历史版本维护   |
-+------------------+------------------+------------------------+----------------+
-| release/v1.1     | v4.0.1           | IDF 版本更新，代码迁移 | 备份，停止维护 |
-+------------------+------------------+------------------------+----------------+
-| release/v1.0     | v3.2.2           | 历史版本               | 备份，停止维护 |
-+------------------+------------------+------------------------+----------------+
+.. list-table:: ESP-IoT-Solution 版本支持情况
+   :header-rows: 1
+   :widths: 20 20 30 20
+
+   * - ESP-IoT-Solution
+     - 依赖的 ESP-IDF
+     - 主要变更
+     - 支持状态
+   * - master
+     - >= v5.3
+     - 新芯片支持
+     - 新功能开发分支
+   * - release/v2.0
+     - <= v5.3, >= v4.4
+     - 支持组件管理器
+     - 历史版本维护
+   * - release/v1.1
+     - v4.0.1
+     - IDF 版本更新，代码迁移
+     - 备份，停止维护
+   * - release/v1.0
+     - v3.2.2
+     - 历史版本
+     - 备份，停止维护
 
 
 开发环境搭建
@@ -45,8 +58,8 @@ ESP-IDF 是乐鑫为 ESP 系列芯片提供的物联网开发框架：
 
 ESP 系列 SoC 支持以下功能：
 
-- Wi-Fi (2.4 GHz/5 GHz 双频)
-- 蓝牙 5.x (BLE/Mesh)
+- Wi-Fi（2.4 GHz/5 GHz 双频）
+- 蓝牙 5.x（BLE/Mesh）
 - 高性能多核处理器，主频最高可达 400 MHz
 - 超低功耗协处理器和深度睡眠模式
 - 丰富的外设接口：
@@ -94,7 +107,7 @@ ESP 系列 SoC 采用先进工艺制程，提供业界领先的射频性能、
 如何使用示例程序
 --------------------------
 
-ESP-IoT-Solution 提供了丰富的示例程序，帮助用户快速上手。以 ``button_power_save``  示例为例：
+ESP-IoT-Solution 提供了丰富的示例程序，帮助用户快速上手。以 ``button_power_save`` 示例为例：
 
 1. 确保已经完成 ESP-IDF 开发环境的搭建，并成功配置了环境变量
 

docs/zh_CN/security_solution/flash_encryption.rst

@@ -1,46 +1,46 @@
 Flash 加密
 ****************
 
-flash 加密是 ESP32 系列芯片的重要安全特性，用于保护存储在外部 flash 中固件和数据的机密性。启用 flash 加密后，flash 中的内容将被透明加密，防止通过物理方式读取获得明文固件和数据。
+Flash 加密是 ESP32 系列芯片的重要安全特性，用于保护存储在外部 Flash 中固件和数据的机密性。启用 Flash 加密后，Flash 中的内容将被透明加密，防止通过物理方式读取获得明文固件和数据。
 
-flash 加密的核心特点：
+Flash 加密的核心特点：
 
 - **透明加密解密**：通过 MMU 缓存访问时自动处理加密解密
 - **硬件实现**：加密密钥存储在 eFuse 中，软件无法直接访问
 - **XTS-AES 算法**：采用专为存储设备设计的安全加密算法
 - **分区选择性加密**：可指定需要加密的分区类型
 
-更多详细信息请参考：`ESP-IDF flash 加密文档 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html>`_
+更多详细信息请参考：`ESP-IDF Flash 加密文档 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html>`_
 
-flash 加密与安全启动
+Flash 加密与安全启动
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-flash 加密与安全启动是互补的安全功能：
+Flash 加密与安全启动是互补的安全功能：
 
-- **flash 加密**：保护数据机密性，防止读取 flash 内容
+- **Flash 加密**：保护数据机密性，防止读取 Flash 内容
 - **安全启动**：保证代码完整性，防止运行未授权固件
 
-建议在生产环境中同时启用两项功能以获得最佳安全保护。详情参考：`flash 加密与安全启动 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#flash-encryption-and-secure-boot>`_
+建议在生产环境中同时启用两项功能以获得最佳安全保护。详情参考：`Flash 加密与安全启动 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#flash-encryption-and-secure-boot>`_
 
 加密范围
 ~~~~~~~~~
 
-flash 加密会自动加密以下内容：
+Flash 加密会自动加密以下内容：
 
 - 二级引导加载程序
 - 所有 app 类型分区
 - 分区表
 - NVS 密钥分区
 - 用户标记为 "encrypted" 的分区
 
-**重要提示**：NVS 分区加密和 flash 加密是两个独立的功能。需要使用 NVS 加密功能。详见：`NVS 加密文档 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/storage/nvs_encryption.html>`_
+**重要提示**：NVS 分区加密和 Flash 加密是两个独立的功能。需要使用 NVS 加密功能。详见：`NVS 加密文档 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/storage/nvs_encryption.html>`_
 
 加密范围详细说明：`加密分区 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#encrypted-partitions>`_
 
-flash 加密功能支持列表
+Flash 加密功能支持列表
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-以下是根据知识源整理的 ESP32 系列芯片 Flash 加密功能对比表，包含加密算法、密钥长度/类型、硬件支持、密钥存储方式、密钥来源（精简描述）：
+以下是 ESP32 系列芯片 Flash 加密功能对比表，包含加密算法、密钥长度/类型、硬件支持、密钥存储方式、密钥来源（精简描述）：
 
 .. list-table:: ESP32 系列芯片 Flash 加密功能对比
     :header-rows: 1
@@ -107,13 +107,13 @@ flash 加密功能支持列表
       - 硬件随机数或主机生成
 
 **说明：**
-- ESP32-C5 支持 Key Manager 作为密钥来源和存储方式[ESP32-C5 SoC Capability Macros](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c5/api-reference/system/soc_caps.html#macros)。
-- 其它芯片均为 eFuse 存储，密钥可由硬件随机数生成或主机生成后烧录[ESP32-S2 Flash Encryption](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/security/flash-encryption.html#key-points-about-flash-encryption)[ESP32-C3 Flash Encryption](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/security/flash-encryption.html)。
+- ESP32-C5 支持 Key Manager 作为密钥来源和存储方式 [ESP32-C5 SoC Capability Macros](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c5/api-reference/system/soc_caps.html#macros)。
+- 其它芯片均为 eFuse 存储，密钥可由硬件随机数生成或主机生成后烧录 [ESP32-S2 Flash Encryption](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/security/flash-encryption.html#key-points-about-flash-encryption)[ESP32-C3 Flash Encryption](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/security/flash-encryption.html)。
 
 开发模式和发布模式
 ~~~~~~~~~~~~~~~~~~~~~
 
-flash 加密提供两种模式：
+Flash 加密提供两种模式：
 
 **开发模式 (Development Mode)**
 
@@ -131,43 +131,43 @@ flash 加密提供两种模式：
 
 **状态检查**：
 
-- 使用 `esp_flash_encryption_enabled() <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/peripherals/spi_flash/index.html#_CPPv428esp_flash_encryption_enabledv>`__ 检查 flash 加密状态
+- 使用 `esp_flash_encryption_enabled() <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/peripherals/spi_flash/index.html#_CPPv428esp_flash_encryption_enabledv>`__ 检查 Flash 加密状态
 - 使用 `esp_get_flash_encryption_mode() <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/peripherals/spi_flash/index.html#_CPPv429esp_get_flash_encryption_modev>`__ 获取加密模式（开发模式或发布模式）
 
-配置方法详见：`flash 加密设置 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#id4>`_
+配置方法详见：`Flash 加密设置 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#id4>`_
 
 加密过程
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-flash 加密的基本过程：
+Flash 加密的基本过程：
 
 1. **首次启动**：检测 eFuse 状态，启动加密流程
 2. **密钥生成**：生成随机加密密钥并存储到 eFuse （可跳过，支持烧录自定义密钥）
-3. **就地加密**：加密 flash 中的指定分区内容
-4. **设置标志**：标记 flash 加密已启用
+3. **就地加密**：加密 Flash 中的指定分区内容
+4. **设置标志**：标记 Flash 加密已启用
 5. **重启系统**：开始正常的加密模式运行
 
-完整的加密过程说明：`flash 的加密过程 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#id3>`_
+完整的加密过程说明：`Flash 的加密过程 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#id3>`_
 
 应用程序访问加密分区
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-应用程序可以透明地访问加密的 flash 内容：
+应用程序可以透明地访问加密的 Flash 内容：
 
-**读取加密 flash**：
+**读取加密 Flash**：
 
 - 使用 `esp_partition_read() <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/storage/partition.html#_CPPv418esp_partition_readPK15esp_partition_t6size_tPv6size_t>`__ 或 `esp_flash_read_encrypted() <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/peripherals/spi_flash/index.html#_CPPv424esp_flash_read_encryptedP11esp_flash_t8uint32_tPv8uint32_t>`__ 读取明文内容（自动解密）
 - 使用 `esp_flash_read() <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/peripherals/spi_flash/index.html#_CPPv414esp_flash_readP11esp_flash_tPv8uint32_t8uint32_t>`__ 读取原始加密数据（不解密）
 
-**写入加密 flash**：
+**写入加密 Flash**：
 
 - 使用 `esp_partition_write() <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/storage/partition.html#_CPPv419esp_partition_writePK15esp_partition_t6size_tPKv6size_t>`__ 写入明文内容（自动加密）
 - 使用 `esp_flash_write_encrypted() <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/api-reference/peripherals/spi_flash/index.html#_CPPv425esp_flash_write_encryptedP11esp_flash_t8uint32_tPKv8uint32_t>`__ 写入原始加密内容（跳过自动加密）
 
 
-更多 API 详情：`在加密的 flash 中读写数据 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#reading-writing-content>`_
+更多 API 详情：`在加密的 Flash 中读写数据 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#reading-writing-content>`_
 
-重新烧录 flash
+重新烧录 Flash
 ~~~~~~~~~~~~~~~
 
 **开发模式下**：
@@ -178,30 +178,30 @@ flash 加密的基本过程：
 **发布模式下**：
 
 - 只能通过 OTA 更新明文固件
-- 只能手动烧录密文固件 (仅当 UART ROM Downloads 启用时支持)
+- 只能手动烧录密文固件（仅当 UART ROM Downloads 启用时支持）
 
 详细说明：`重新烧录更新后的分区 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#encrypt-partitions>`_
 
 取消加密
 ~~~~~~~~~~~
 
-**仅开发模式支持** （发布模式无法取消）：在加密状态下通过烧录 eFuse ``SPI_BOOT_CRYPT_CNT`` 以禁用 flash 加密。
+**仅开发模式支持**（发布模式无法取消）：在加密状态下通过烧录 eFuse ``SPI_BOOT_CRYPT_CNT`` 以禁用 Flash 加密。
 
 **警告**：每个芯片只有有限次数的开关加密次数，通常为 3 次（关闭->开启->关闭->开启），请谨慎操作。
 
-详细步骤：`关闭 flash 加密 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#disabling-flash-encryption>`_
+详细步骤：`关闭 Flash 加密 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#disabling-flash-encryption>`_
 
 示例代码
 ~~~~~~~~~~~
 
-完整的 flash 加密使用示例请参考：
+完整的 Flash 加密使用示例请参考：
 
-- `ESP-IDF flash 加密示例 <https://github.com/espressif/esp-idf/tree/master/examples/security/flash_encryption>`_
+- `ESP-IDF Flash 加密示例 <https://github.com/espressif/esp-idf/tree/master/examples/security/flash_encryption>`_
 - `安全功能综合示例 <https://github.com/espressif/esp-idf/tree/master/examples/security/security_features_app>`_
 
 这些示例展示了：
 
-- flash 加密状态检查
+- Flash 加密状态检查
 - 加密分区读写操作  
 - NVS 和 FATFS 在加密环境下的使用
 - 开发模式和发布模式的配置方法
@@ -215,7 +215,7 @@ flash 加密的基本过程：
 4. **合理规划分区加密策略**
 5. **测试 OTA 更新流程**
 
-更多最佳实践：`flash 加密最佳实践 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#flash-encrypt-best-practices>`_
+更多最佳实践：`Flash 加密最佳实践 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32s3/security/flash-encryption.html#flash-encrypt-best-practices>`_
 
 常见问题 (FAQ)
 ~~~~~~~~~~~~~~~~~