diff --git a/docs/en/installing.rst b/docs/en/installing.rst
index 491e8f6d8a4..979a576f2db 100644
--- a/docs/en/installing.rst
+++ b/docs/en/installing.rst
@@ -85,8 +85,19 @@ PlatformIO can be used in two flavors:
 
 To install PlatformIO, you can follow this Getting Started, provided at `docs.platformio.org`_.
 
-Using the stable code
-*********************
+For more information about PlatformIO, see the following links:
+
+- `PlatformIO Core (CLI) <https://docs.platformio.org/en/latest/core/index.html>`_
+
+- `PlatformIO Home <https://docs.platformio.org/en/latest/home/index.html>`_
+
+- `Tutorials and Examples <https://docs.platformio.org/en/latest/tutorials/index.html>`_
+
+- `Library Management <https://docs.platformio.org/en/latest/librarymanager/index.html>`_
+
+
+Using the stable code 2.0.x
+---------------------------
 
 .. note::
    A detailed overview of supported development boards, examples and frameworks can be found on `the official Espressif32 dev-platform page <https://registry.platformio.org/platforms/platformio/espressif32>`_ in the PlatformIO Registry.
@@ -100,7 +111,7 @@ Create a new project and select one of the available boards. You can change afte
 .. code-block:: bash
 
    [env:esp32dev]
-   platform = espressif32
+   platform = espressif32@6.8.1
    board = esp32dev
    framework = arduino
 
@@ -109,7 +120,7 @@ Create a new project and select one of the available boards. You can change afte
 .. code-block:: bash
 
    [env:esp32-s2-saola-1]
-   platform = espressif32
+   platform = espressif32@6.8.1
    board = esp32-s2-saola-1
    framework = arduino
 
@@ -118,35 +129,24 @@ Create a new project and select one of the available boards. You can change afte
 .. code-block:: bash
 
    [env:esp32-c3-devkitm-1]
-   platform = espressif32
+   platform = espressif32@6.8.1
    board = esp32-c3-devkitm-1
    framework = arduino
 
-How to update to the latest code
-********************************
+How to update to the stable code based on 3.0.x 
+-----------------------------------------------
 
-To test the latest Arduino ESP32, you need to change your project *platformio.ini* accordingly.
-The following configuration uses the upstream version of the Espressif development platform and the latest Arduino core directly from the Espressif GitHub repository:
+To use the latest supported Arduino ESP32, you need to change your project *platformio.ini* accordingly.
+The following configuration uses the community version ``pioarduino`` and the latest release Arduino core from the ``espressif`` GitHub repository:
 
+.. note:: This is only an example. Make sure to check the latest available version in `pioarduino's repository <https://github.com/pioarduino/platform-espressif32/releases>`_.
 .. code-block:: bash
 
    [env:esp32-c3-devkitm-1]
-   platform = https://github.com/platformio/platform-espressif32.git
+   platform = https://github.com/pioarduino/platform-espressif32/releases/download/51.03.05/platform-espressif32.zip
    board = esp32-c3-devkitm-1
    framework = arduino
-   platform_packages =
-       framework-arduinoespressif32 @ https://github.com/espressif/arduino-esp32#master
-
-
-To get more information about PlatformIO, see the following links:
-
-- `PlatformIO Core (CLI) <https://docs.platformio.org/en/latest/core/index.html>`_
 
-- `PlatformIO Home <https://docs.platformio.org/en/latest/home/index.html>`_
-
-- `Tutorials and Examples <https://docs.platformio.org/en/latest/tutorials/index.html>`_
-
-- `Library Management <https://docs.platformio.org/en/latest/librarymanager/index.html>`_
 
 
 Windows (manual installation)