Sync Docs platformio/platformio-core@d224ae6

en/latest/_sources/faq/install-python.rst.txt

@@ -15,11 +15,20 @@ Install Python Interpreter
 --------------------------
 
 :ref:`piocore` is written in `Python <https://www.python.org/downloads/>`_ that
-is installed by default on the all popular OS except Windows.
+is installed by default on all the popular OSs except Windows.
 
 Please navigate to official website and `Download the latest Python <https://www.python.org/downloads/>`_
 and install it. Please **READ NOTES BELOW**.
 
+:Linux:
+  Most linux distributions will include a Python installation already. You may need to ensure that the Python Virtual Environment is installed.
+
+  Debian/Ubuntu derivatives have this package in Apt as ``python3-venv``.
+
+  ``sudo apt install python3-venv`` should be all that is required.
+
+  For more details, please check the `platformio-core-installer/issues/85 <https://github.com/platformio/platformio-core-installer/issues/85>`__.
+
 :macOS:
   Please read the "Important Information" displayed during installation for information
   about SSL/TLS certificate validation and the running the **"Install Certificates.command"**.

en/latest/faq/install-python.html

@@ -142,18 +142,24 @@
   <section id="install-python-interpreter">
 <span id="faq-install-python"></span><h1>Install Python Interpreter<a class="headerlink" href="#install-python-interpreter" title="Link to this heading"></a></h1>
 <p><a class="reference internal" href="../core/index.html#piocore"><span class="std std-ref">PlatformIO Core (CLI)</span></a> is written in <a class="reference external" href="https://www.python.org/downloads/">Python</a> that
-is installed by default on the all popular OS except Windows.</p>
+is installed by default on all the popular OSs except Windows.</p>
 <p>Please navigate to official website and <a class="reference external" href="https://www.python.org/downloads/">Download the latest Python</a>
 and install it. Please <strong>READ NOTES BELOW</strong>.</p>
 <dl class="field-list">
-<dt class="field-odd">macOS<span class="colon">:</span></dt>
-<dd class="field-odd"><p>Please read the “Important Information” displayed during installation for information
+<dt class="field-odd">Linux<span class="colon">:</span></dt>
+<dd class="field-odd"><p>Most linux distributions will include a Python installation already. You may need to ensure that the Python Virtual Environment is installed.</p>
+<p>Debian/Ubuntu derivatives have this package in Apt as <code class="docutils literal notranslate"><span class="pre">python3-venv</span></code>.</p>
+<p><code class="docutils literal notranslate"><span class="pre">sudo</span> <span class="pre">apt</span> <span class="pre">install</span> <span class="pre">python3-venv</span></code> should be all that is required.</p>
+<p>For more details, please check the <a class="reference external" href="https://github.com/platformio/platformio-core-installer/issues/85">platformio-core-installer/issues/85</a>.</p>
+</dd>
+<dt class="field-even">macOS<span class="colon">:</span></dt>
+<dd class="field-even"><p>Please read the “Important Information” displayed during installation for information
 about SSL/TLS certificate validation and the running the <strong>“Install Certificates.command”</strong>.</p>
 <p>If you do not install SSL/TLS certificates, PlatformIO will not be able to download
 dependent packages, libraries, and toolchains.</p>
 </dd>
-<dt class="field-even">Windows<span class="colon">:</span></dt>
-<dd class="field-even"><p>Please select <code class="docutils literal notranslate"><span class="pre">Add</span> <span class="pre">Python</span> <span class="pre">to</span> <span class="pre">Path</span></code> (see below), otherwise, <code class="docutils literal notranslate"><span class="pre">python</span></code> command will
+<dt class="field-odd">Windows<span class="colon">:</span></dt>
+<dd class="field-odd"><p>Please select <code class="docutils literal notranslate"><span class="pre">Add</span> <span class="pre">Python</span> <span class="pre">to</span> <span class="pre">Path</span></code> (see below), otherwise, <code class="docutils literal notranslate"><span class="pre">python</span></code> command will
 not be available.</p>
 <img alt="../_images/python-installer-add-path.png" src="../_images/python-installer-add-path.png" />
 </dd>