doc: getting_started: remove global Python setup

As it was already outlined, installing Python dependencies at a system
level or user level can be dangerous. For this reason, the default setup
instructions already pointed users to use Python virtual environments. On
newer Ubuntu installations (23.04 onwards) system-level pip installs are
not allowed. Let's make Zephyr _Python-safe_ as well by removing dangerous
instructions.

Signed-off-by: Gerard Marull-Paretas <[email protected]>

Author: gmarull

doc/develop/getting_started/index.rst

@@ -207,298 +207,176 @@ Get Zephyr and install Python dependencies
 
 Next, clone Zephyr and its :ref:`modules <modules>` into a new :ref:`west
 <west>` workspace named :file:`zephyrproject`. You'll also install Zephyr's
-additional Python dependencies.
+additional Python dependencies in a `Python virtual environment`_.
 
-
-.. note::
-
-    It is easy to run into Python package incompatibilities when installing
-    dependencies at a system or user level. This situation can happen,
-    for example, if working on multiple Zephyr versions or other projects
-    using Python on the same machine.
-
-    For this reason it is suggested to use `Python virtual environments`_.
-
-.. _Python virtual environments: https://docs.python.org/3/library/venv.html
+.. _Python virtual environment: https://docs.python.org/3/library/venv.html
 
 .. tabs::
 
    .. group-tab:: Ubuntu
 
-      .. tabs::
-
-         .. group-tab:: Install within virtual environment
-
-            #. Use ``apt`` to install Python ``venv`` package:
-
-               .. code-block:: bash
-
-                  sudo apt install python3-venv
-
-            #. Create a new virtual environment:
-
-               .. code-block:: bash
-
-                  python3 -m venv ~/zephyrproject/.venv
-
-            #. Activate the virtual environment:
-
-               .. code-block:: bash
-
-                  source ~/zephyrproject/.venv/bin/activate
-
-               Once activated your shell will be prefixed with ``(.venv)``. The
-               virtual environment can be deactivated at any time by running
-               ``deactivate``.
-
-               .. note::
-
-                  Remember to activate the virtual environment every time you
-                  start working.
+      #. Use ``apt`` to install Python ``venv`` package:
 
-            #. Install west:
-
-               .. code-block:: bash
-
-                  pip install west
+         .. code-block:: bash
 
-            #. Get the Zephyr source code:
+            sudo apt install python3-venv
 
-               .. code-block:: bash
+      #. Create a new virtual environment:
 
-                 west init ~/zephyrproject
-                 cd ~/zephyrproject
-                 west update
+         .. code-block:: bash
 
-            #. Export a :ref:`Zephyr CMake package <cmake_pkg>`. This allows CMake to
-               automatically load boilerplate code required for building Zephyr
-               applications.
+            python3 -m venv ~/zephyrproject/.venv
 
-               .. code-block:: bash
+      #. Activate the virtual environment:
 
-                  west zephyr-export
+         .. code-block:: bash
 
-            #. Zephyr's ``scripts/requirements.txt`` file declares additional Python
-               dependencies. Install them with ``pip``.
+            source ~/zephyrproject/.venv/bin/activate
 
-               .. code-block:: bash
+         Once activated your shell will be prefixed with ``(.venv)``. The
+         virtual environment can be deactivated at any time by running
+         ``deactivate``.
 
-                  pip install -r ~/zephyrproject/zephyr/scripts/requirements.txt
+         .. note::
 
-         .. group-tab:: Install globally
+            Remember to activate the virtual environment every time you
+            start working.
 
-            #. Install west, and make sure :file:`~/.local/bin` is on your
-               :envvar:`PATH` :ref:`environment variable <env_vars>`:
+      #. Install west:
 
-               .. code-block:: bash
+         .. code-block:: bash
 
-                  pip3 install --user -U west
-                  echo 'export PATH=~/.local/bin:"$PATH"' >> ~/.bashrc
-                  source ~/.bashrc
+            pip install west
 
-            #. Get the Zephyr source code:
+      #. Get the Zephyr source code:
 
-               .. code-block:: bash
+         .. code-block:: bash
 
-                  west init ~/zephyrproject
-                  cd ~/zephyrproject
-                  west update
+           west init ~/zephyrproject
+           cd ~/zephyrproject
+           west update
 
-            #. Export a :ref:`Zephyr CMake package <cmake_pkg>`. This allows CMake to
-               automatically load boilerplate code required for building Zephyr
-               applications.
+      #. Export a :ref:`Zephyr CMake package <cmake_pkg>`. This allows CMake to
+         automatically load boilerplate code required for building Zephyr
+         applications.
 
-               .. code-block:: bash
+         .. code-block:: bash
 
-                  west zephyr-export
+            west zephyr-export
 
-            #. Zephyr's ``scripts/requirements.txt`` file declares additional Python
-               dependencies. Install them with ``pip3``.
+      #. Zephyr's ``scripts/requirements.txt`` file declares additional Python
+         dependencies. Install them with ``pip``.
 
-               .. code-block:: bash
+         .. code-block:: bash
 
-                  pip3 install --user -r ~/zephyrproject/zephyr/scripts/requirements.txt
+            pip install -r ~/zephyrproject/zephyr/scripts/requirements.txt
 
    .. group-tab:: macOS
 
-      .. tabs::
-
-         .. group-tab:: Install within virtual environment
-
-            #. Create a new virtual environment:
-
-               .. code-block:: bash
-
-                  python3 -m venv ~/zephyrproject/.venv
-
-            #. Activate the virtual environment:
-
-               .. code-block:: bash
-
-                  source ~/zephyrproject/.venv/bin/activate
-
-               Once activated your shell will be prefixed with ``(.venv)``. The
-               virtual environment can be deactivated at any time by running
-               ``deactivate``.
-
-               .. note::
+      #. Create a new virtual environment:
 
-                  Remember to activate the virtual environment every time you
-                  start working.
-
-            #. Install west:
-
-               .. code-block:: bash
-
-                  pip install west
-
-            #. Get the Zephyr source code:
-
-               .. code-block:: bash
-
-                  west init ~/zephyrproject
-                  cd ~/zephyrproject
-                  west update
+         .. code-block:: bash
 
-            #. Export a :ref:`Zephyr CMake package <cmake_pkg>`. This allows CMake to
-               automatically load boilerplate code required for building Zephyr
-               applications.
+            python3 -m venv ~/zephyrproject/.venv
 
-               .. code-block:: bash
+      #. Activate the virtual environment:
 
-                  west zephyr-export
+         .. code-block:: bash
 
-            #. Zephyr's ``scripts/requirements.txt`` file declares additional Python
-               dependencies. Install them with ``pip``.
+            source ~/zephyrproject/.venv/bin/activate
 
-               .. code-block:: bash
+         Once activated your shell will be prefixed with ``(.venv)``. The
+         virtual environment can be deactivated at any time by running
+         ``deactivate``.
 
-                  pip install -r ~/zephyrproject/zephyr/scripts/requirements.txt
+         .. note::
 
-         .. group-tab:: Install globally
+            Remember to activate the virtual environment every time you
+            start working.
 
-            #. Install west:
+      #. Install west:
 
-               .. code-block:: bash
+         .. code-block:: bash
 
-                  pip3 install -U west
+            pip install west
 
-            #. Get the Zephyr source code:
+      #. Get the Zephyr source code:
 
-               .. code-block:: bash
+         .. code-block:: bash
 
-                  west init ~/zephyrproject
-                  cd ~/zephyrproject
-                  west update
+            west init ~/zephyrproject
+            cd ~/zephyrproject
+            west update
 
-            #. Export a :ref:`Zephyr CMake package <cmake_pkg>`. This allows CMake to
-               automatically load boilerplate code required for building Zephyr
-               applications.
+      #. Export a :ref:`Zephyr CMake package <cmake_pkg>`. This allows CMake to
+         automatically load boilerplate code required for building Zephyr
+         applications.
 
-               .. code-block:: bash
+         .. code-block:: bash
 
-                  west zephyr-export
+            west zephyr-export
 
-            #. Zephyr's ``scripts/requirements.txt`` file declares additional Python
-               dependencies. Install them with ``pip3``.
+      #. Zephyr's ``scripts/requirements.txt`` file declares additional Python
+         dependencies. Install them with ``pip``.
 
-               .. code-block:: bash
+         .. code-block:: bash
 
-                  pip3 install -r ~/zephyrproject/zephyr/scripts/requirements.txt
+            pip install -r ~/zephyrproject/zephyr/scripts/requirements.txt
 
    .. group-tab:: Windows
 
-      .. tabs::
-
-         .. group-tab:: Install within virtual environment
-
-            #. Open a ``cmd.exe`` terminal window **as a regular user**
-
-            #. Create a new virtual environment:
-
-               .. code-block:: bat
-
-                  cd %HOMEPATH%
-                  python -m venv zephyrproject\.venv
-
-            #. Activate the virtual environment:
+      #. Open a ``cmd.exe`` terminal window **as a regular user**
 
-               .. code-block:: bat
+      #. Create a new virtual environment:
 
-                  zephyrproject\.venv\Scripts\activate.bat
-
-               Once activated your shell will be prefixed with ``(.venv)``. The
-               virtual environment can be deactivated at any time by running
-               ``deactivate``.
-
-               .. note::
-
-                  Remember to activate the virtual environment every time you
-                  start working.
-
-            #. Install west:
-
-               .. code-block:: bat
-
-                  pip install west
-
-            #. Get the Zephyr source code:
-
-               .. code-block:: bat
-
-                  west init zephyrproject
-                  cd zephyrproject
-                  west update
-
-            #. Export a :ref:`Zephyr CMake package <cmake_pkg>`. This allows CMake to
-               automatically load boilerplate code required for building Zephyr
-               applications.
-
-               .. code-block:: bat
+         .. code-block:: bat
 
-                  west zephyr-export
+            cd %HOMEPATH%
+            python -m venv zephyrproject\.venv
 
-            #. Zephyr's ``scripts\requirements.txt`` file declares additional Python
-               dependencies. Install them with ``pip``.
+      #. Activate the virtual environment:
 
-               .. code-block:: bat
+         .. code-block:: bat
 
-                  pip install -r %HOMEPATH%\zephyrproject\zephyr\scripts\requirements.txt
+            zephyrproject\.venv\Scripts\activate.bat
 
-         .. group-tab:: Install globally
+         Once activated your shell will be prefixed with ``(.venv)``. The
+         virtual environment can be deactivated at any time by running
+         ``deactivate``.
 
-            #. Open a ``cmd.exe`` terminal window **as a regular user**
+         .. note::
 
-            #. Install west:
+            Remember to activate the virtual environment every time you
+            start working.
 
-               .. code-block:: bat
+      #. Install west:
 
-                  pip3 install -U west
+         .. code-block:: bat
 
-            #. Get the Zephyr source code:
+            pip install west
 
-               .. code-block:: bat
+      #. Get the Zephyr source code:
 
-                  cd %HOMEPATH%
-                  west init zephyrproject
-                  cd zephyrproject
-                  west update
+         .. code-block:: bat
 
-            #. Export a :ref:`Zephyr CMake package <cmake_pkg>`. This allows CMake to
-               automatically load boilerplate code required for building Zephyr
-               applications.
+            west init zephyrproject
+            cd zephyrproject
+            west update
 
-               .. code-block:: bat
+      #. Export a :ref:`Zephyr CMake package <cmake_pkg>`. This allows CMake to
+         automatically load boilerplate code required for building Zephyr
+         applications.
 
-                  west zephyr-export
+         .. code-block:: bat
 
-            #. Zephyr's ``scripts\requirements.txt`` file declares additional Python
-               dependencies. Install them with ``pip3``.
+            west zephyr-export
 
-               .. code-block:: bat
+      #. Zephyr's ``scripts\requirements.txt`` file declares additional Python
+         dependencies. Install them with ``pip``.
 
-                  pip3 install -r %HOMEPATH%\zephyrproject\zephyr\scripts\requirements.txt
+         .. code-block:: bat
 
+            pip install -r %HOMEPATH%\zephyrproject\zephyr\scripts\requirements.txt
 
 Install the Zephyr SDK
 **********************