espressif · Shen7436 · Nov 20, 2025 · Nov 12, 2025
diff --git a/docs/en/additionalfeatures.rst b/docs/en/additionalfeatures.rst
@@ -1,23 +1,24 @@
 Additional IDE Features
-===============================
-.. toctree::
-    :maxdepth: 1
+=======================
 
-    LSP C/C++ Editor<additionalfeatures/lspeditor>
-    CMake Editor<additionalfeatures/cmakeeditor>
-    ESP-IDF Application Size Analysis<additionalfeatures/application-size-analysis>
-    ESP-IDF Terminal<additionalfeatures/esp-terminal>
-    Install ESP-IDF Components<additionalfeatures/install-esp-components>
-    Heap Tracing<additionalfeatures/heaptracing>
-    ESP-IDF OpenOCD Debugging<openocddebugging>
-    GDB Stub Debugging<additionalfeatures/gdbstubdebugging>
-    Core Dump Debugging<additionalfeatures/coredumpdebugging>
-    Application Level Tracing<additionalfeatures/appleveltracing>
-    Partition Table Editor<additionalfeatures/partitiontableeditor>
-    NVS Partition Editor<additionalfeatures/nvspartitioneditor>
-    Write Binary to Flash<additionalfeatures/writebinarytoflash>
-    DFU Flashing<additionalfeatures/dfu>
-    Wokwi Simulator<additionalfeatures/wokwisimulator>
-    Switch Between Languages<additionalfeatures/switchlanguage>
+:link_to_translation:`zh_CN:[中文]`
 
+.. toctree::
+    :maxdepth: 1
 
+    LSP C/C++ Editor <additionalfeatures/lspeditor>
+    CMake Editor <additionalfeatures/cmakeeditor>
+    ESP-IDF Application Size Analysis <additionalfeatures/application-size-analysis>
+    ESP-IDF Terminal <additionalfeatures/esp-terminal>
+    Install ESP-IDF Components <additionalfeatures/install-esp-components>
+    Heap Tracing <additionalfeatures/heaptracing>
+    ESP-IDF OpenOCD Debugging <openocddebugging>
+    GDB Stub Debugging <additionalfeatures/gdbstubdebugging>
+    Core Dump Debugging <additionalfeatures/coredumpdebugging>
+    Application Level Tracing <additionalfeatures/appleveltracing>
+    Partition Table Editor <additionalfeatures/partitiontableeditor>
+    NVS Partition Editor <additionalfeatures/nvspartitioneditor>
+    Write Binary to Flash <additionalfeatures/writebinarytoflash>
+    DFU Flashing <additionalfeatures/dfu>
+    Wokwi Simulator <additionalfeatures/wokwisimulator>
+    Switch Between Languages <additionalfeatures/switchlanguage>
diff --git a/docs/en/configureproject.rst b/docs/en/configureproject.rst
@@ -1,10 +1,13 @@
 Configure Your Project
-===============================
+======================
 
-Project configuration is stored in a single file called ``sdkconfig`` located in the root directory of the project. This configuration file can be modified using the ``SDK Configuration Editor``.
+:link_to_translation:`zh_CN:[中文]`
+
+Project configuration is stored in a single file called ``sdkconfig`` located in the root directory of the project. This configuration file can be modified using the SDK Configuration Editor.
 
 .. note::
-    sdkconfig file is generated only after the build. Hence, it is recommended to build the project once before configuring the project.
+
+    ``sdkconfig`` file is generated only after the build. Hence, it is recommended to build the project once before configuring the project.
 
 To launch the SDK Configuration Editor:
 

diff --git a/docs/en/connectdevice.rst b/docs/en/connectdevice.rst
@@ -1,22 +1,24 @@
 Connect Your Device
-===============================
-Next, select the ESP target for your project (ignore this step if it was already set during project creation) and the serial port of your device by clicking on the gear icon. By default, the launch target dropdown will display all the supported targets provided by the plugin.
+===================
+
+:link_to_translation:`zh_CN:[中文]`
+
+Click the gear icon to select the ESP target for your project and the serial port of your device. Skip this step if these settings were configured during project creation. By default, the launch target dropdown will display all the supported targets provided by the plugin.
 
 .. image:: ../../media/target_selection.png
 
-Clicking the gear icon opens the ESP Target Configuration dialog, where you can select the serial port for your device and specify the ESP board. The plugin will automatically detect serial ports connected to your machine.
+Clicking the gear icon opens the ``ESP Target`` configuration dialog, where you can select the serial port for your device and specify the ESP board. The plugin will automatically detect serial ports connected to your machine.
 
 .. image:: ../../media/8_launch_target.png
 
-Regarding the Serial ports and their patterns, please refer to the `ESP-IDF documentation <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/linux-macos-setup.html#connect-your-device>`_.
+Regarding the serial ports and their patterns, please refer to the `ESP-IDF documentation <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/linux-macos-setup.html#connect-your-device>`_.
 
 Custom Target
-----------------
+-------------
+
 If you need to add a target that is not available in the launch target dropdown, please follow the instructions below:
 
 1. Click on the launch target dropdown.
 2. Select ``New Launch Target``.
 3. Select ``ESP Target``.
-4. Provide properties for the target where you would like to launch the application. Enter a ``Name`` for the target and select the ``Serial Port`` to which your ESP device is connected on your machine.
-
-
+4. Specify the properties of the target device where you want to launch the application. Enter a ``Name`` for the target and select the ``Serial Port`` to which your ESP device is connected on your machine.
diff --git a/docs/en/downloads.rst b/docs/en/downloads.rst
@@ -1,33 +1,39 @@
 .. _downloads:
 
 Espressif-IDE Downloads
-=========================
+=======================
 
-You can find the latest Espressif-IDE release notes from `here <https://github.com/espressif/idf-eclipse-plugin/releases>`_. Provided below are the direct download links for various platforms.
+:link_to_translation:`zh_CN:[中文]`
 
-+--------------+-------------------------------------------------------------------------------------------------------------------------------------------+
-| OS           | Download                                                                                                                                  |
-+==============+===========================================================================================================================================+
-| Windows      | `Espressif-IDE-win32.win32.x86_64 <https://dl.espressif.com/dl/idf-eclipse-plugin/ide/Espressif-IDE-win32.win32.x86_64/latest>`_          |
-+--------------+-------------------------------------------------------------------------------------------------------------------------------------------+
-| macOS x86_64 | `Espressif-IDE-macosx-cocoa-x86_64 <https://dl.espressif.com/dl/idf-eclipse-plugin/ide/Espressif-IDE-macosx-cocoa-x86_64/latest>`_        |
-+--------------+-------------------------------------------------------------------------------------------------------------------------------------------+
-| macOS aarch64| `Espressif-IDE-macosx-cocoa-aarch64 <https://dl.espressif.com/dl/idf-eclipse-plugin/ide/Espressif-IDE-macosx-cocoa-aarch64/latest>`_      |
-+--------------+-------------------------------------------------------------------------------------------------------------------------------------------+
-| Linux        | `Espressif-IDE-linux.gtk.x86_64 <https://dl.espressif.com/dl/idf-eclipse-plugin/ide/Espressif-IDE-linux.gtk.x86_64/latest>`_              |
-+--------------+-------------------------------------------------------------------------------------------------------------------------------------------+
+You can find the latest Espressif-IDE release notes at `here <https://github.com/espressif/idf-eclipse-plugin/releases>`_. Direct download links for various platforms are provided below.
 
+.. list-table::
+   :header-rows: 1
+   :widths: 20 80
 
-macOS security notice (Applicable only for Nightly Builds)
-------------------------------------------------------------
-On macOS, if you download the archive with the browser, the strict security checks on recent macOS will prevent it to run, and complain that the program is damaged. That’s obviously not true, and the fix is simple, you need to remove the `com.apple.quarantine` extended attribute.
+   * - OS
+     - Download
+   * - Windows
+     - `Espressif-IDE-win32.win32.x86_64 <https://dl.espressif.com/dl/idf-eclipse-plugin/ide/Espressif-IDE-win32.win32.x86_64/latest>`_
+   * - macOS x86_64
+     - `Espressif-IDE-macosx-cocoa-x86_64 <https://dl.espressif.com/dl/idf-eclipse-plugin/ide/Espressif-IDE-macosx-cocoa-x86_64/latest>`_
+   * - macOS aarch64
+     - `Espressif-IDE-macosx-cocoa-aarch64 <https://dl.espressif.com/dl/idf-eclipse-plugin/ide/Espressif-IDE-macosx-cocoa-aarch64/latest>`_
+   * - Linux
+     - `Espressif-IDE-linux.gtk.x86_64 <https://dl.espressif.com/dl/idf-eclipse-plugin/ide/Espressif-IDE-linux.gtk.x86_64/latest>`_
+
+
+macOS Security Notice (Applicable Only for Nightly Builds)
+----------------------------------------------------------
+
+On macOS, if you download the archive using a web browser, the strict security checks in recent macOS versions will prevent it from running and display a message that the program is damaged. This is not actually true, and the fix is simple: you just need to remove the ``com.apple.quarantine`` extended attribute.
 
 .. code-block:: shell
 
     $ xattr -d com.apple.quarantine ~/Downloads/Espressif-IDE-x.x.x-macosx.cocoa.x86_64.tar.gz
 
-After un-archiving, if the application still complains, check/remove the attribute from the Espressif-IDE.app folder too:
+After unpacking the archive, if the application still shows the same warning, check and remove the attribute from the ``Espressif-IDE.app`` folder as well:
 
 .. code-block:: shell
 
-    $ xattr -dr com.apple.quarantine ~/Downloads/Espressif-IDE.app
+    $ xattr -dr com.apple.quarantine ~/Downloads/Espressif-IDE.app