Work in progress on the Getting started and install guide

Author: pedrominatel

README.md

@@ -9,7 +9,6 @@
 - [Installation Instructions](#installation-instructions)
 - [Decoding Exceptions](#decoding-exceptions)
 - [Issue/Bug report template](#issuebug-report-template)
-- [ESP32Dev Board PINMAP](#esp32dev-board-pinmap)
 
 ### ESP32-S2 and ESP32-C3 Support
 If you want to test ESP32-S2 and/or ESP32-C3 through the board manager, please use the development release link: `https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_dev_index.json` and install the latest 2.0.0 version.
@@ -22,6 +21,7 @@ Latest Development Release  [![Release Version](https://img.shields.io/github/re
 
 
 ### Installation Instructions
+
 - Using Arduino IDE Boards Manager (preferred)
   + [Instructions for Boards Manager](docs/arduino-ide/boards_manager.md)
 - Using Arduino IDE with the development repository
@@ -30,9 +30,9 @@ Latest Development Release  [![Release Version](https://img.shields.io/github/re
   + [Instructions for Debian/Ubuntu Linux](docs/arduino-ide/debian_ubuntu.md)
   + [Instructions for Fedora](docs/arduino-ide/fedora.md)
   + [Instructions for openSUSE](docs/arduino-ide/opensuse.md)
-- [Using PlatformIO](docs/platformio.md)
+- REMOVE: [Using PlatformIO](docs/platformio.md)
 - [Building with make](docs/make.md)
-- [Using as ESP-IDF component](docs/esp-idf_component.md)
+- REMOVE: [Using as ESP-IDF component](docs/esp-idf_component.md)
 - [Using OTAWebUpdater](docs/OTAWebUpdate/OTAWebUpdate.md)
 
 ### Decoding exceptions

docs/source/getting_started.rst

@@ -7,5 +7,8 @@ About Arduino ESP32
 How to Contribute
 -----------------
 
-Installation
-------------
+Supported Operational Systems
+-----------------------------
+
+Currently, the supported OS are: Windows, Linux and macOS.
+

docs/source/installing.rst

@@ -1,16 +1,22 @@
+**********
 Installing
-==========
+**********
 
 Before Installing
 -----------------
 
+
+
 Installing using Boards Manager
 -------------------------------
 
 -  Stable release link:
-   ``https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json``
+
+   https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
+
 -  Development release link:
-   ``https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_dev_index.json``
+
+   https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_dev_index.json
 
 Starting with 1.6.4, Arduino allows installation of third-party platform
 packages using Boards Manager. We have packages available for Windows,
@@ -33,4 +39,23 @@ Linux
 -----
 
 MacOS
------
+-----
+
+
+PlatformIO
+----------
+
+Installation instructions for using PlatformIO
+**********************************************
+
+`What is PlatformIO? <https://docs.platformio.org/en/latest/what-is-platformio.html?utm_source=github&utm_medium=arduino-esp32>`_
+
+`PlatformIO IDE <https://platformio.org/platformio-ide?utm_source=github&utm_medium=arduino-esp32>`_
+
+`PlatformIO Core <https://docs.platformio.org/en/latest/core.html?utm_source=github&utm_medium=arduino-esp32>`_
+
+`Advanced usage <https://docs.platformio.org/en/latest/platforms/espressif32.html?utm_source=github&utm_medium=arduino-esp32>`_: Custom settings, uploading to SPIFFS, Over-the-Air (OTA), staging version
+
+`Integration with Cloud and Standalone IDEs <https://docs.platformio.org/en/latest/ide.html?utm_source=github&utm_medium=arduino-esp32>`_: Cloud9, Codeanywhere, Eclipse Che (Codenvy), Atom, CLion, Eclipse, Emacs, NetBeans, Qt Creator, Sublime Text, VIM, Visual Studio, and VSCode
+
+`Project Examples <https://docs.platformio.org/en/latest/platforms/espressif32.html?utm_source=github&utm_medium=arduino-esp32#examples>`_