update installation instructions for current ecosystem (#2912)

Author: david-cortes-intel

doc/sources/quick-start.rst

@@ -53,22 +53,21 @@ Alternatively, functions and classes from the |sklearnex| can be imported direct
   from sklearnex.linear_model import LinearRegression
 
 Installation
---------------------
-
-.. contents:: :local:
+------------
 
-.. tip:: To prevent version conflicts, we recommend creating and activating a new environment for |sklearnex|.
+The |sklearnex| can be easily installed as a Python package under name ``scikit-learn-intelex`` from the most
+common distribution channels for Python.
 
-Install from PyPI
-**********************
+Installing from PyPI
+********************
 
-Recommended by default.
+To install with ``pip`` from the public Python Package Index (PyPI), execute the following command on a terminal: ::
 
-To install |sklearnex|, run:
+  pip install scikit-learn-intelex
 
-::
+.. tip:: Running on GPU involves additional dependencies, see :doc:`oneapi-gpu`. SPMD mode has additional requirements on top of GPU ones, see :doc:`distributed-mode` for details.
 
-  pip install scikit-learn-intelex
+.. tip:: To prevent version conflicts, we recommend creating and activating a new virtual environment for |sklearnex|.
 
 .. tip:: Wheels are also available through Intel's index: ``https://software.repos.intel.com/python/pypi``
 
@@ -86,91 +85,61 @@ To install |sklearnex|, run:
    * - Modes
      - Single, SPMD (Linux* only)
 
-.. tip:: Running on GPU involves additional dependencies, see :doc:`oneapi-gpu`. SPMD mode has additional requirements on top of GPU ones, see :doc:`distributed-mode` for details.
-
 .. note:: Wheels are only available for x86-64 architecture.
 
-Install through Conda
-*********************
-
-To prevent version conflicts, we recommend installing ``scikit-learn-intelex`` into a new conda environment.
-
-.. note::
-  The main Anaconda channel also provides distributions of ``scikit-learn-intelex``, but it does not provide the latest versions, nor does
-  it provide GPU-enabled builds. It is highly recommended to install ``scikit-learn-intelex`` from either Intel's channel or from conda-forge instead.
-
-.. tabs::
-
-   .. tab:: Intel channel
-
-      Recommended for the Intel® Distribution for Python users.
-
-      To install in a fresh environment: ::
-
-        conda create -n sklex -c https://software.repos.intel.com/python/conda/ -c conda-forge --override-channels scikit-learn-intelex
-        conda activate sklex
-
-      To install in an existing environment: ::
-
-        conda install -c https://software.repos.intel.com/python/conda/ -c conda-forge --override-channels scikit-learn-intelex
+Installing from conda-forge
+***************************
 
-      .. warning::
-        Packages from the Intel channel are meant to be used together with dependencies from the **conda-forge** channel, and might not
-        work correctly when used in an environment where packages from the ``anaconda`` default channel have been installed. It is
-        advisable to use the `miniforge <https://github.com/conda-forge/miniforge>`__ installer for ``conda``/``mamba``, as it comes with
-        ``conda-forge`` as the only default channel.
+To install the |sklearnex| in a fresh environment, execute the following command in a terminal: ::
 
-      .. list-table:: **Supported Configurations**
-         :align: left
+  conda create -n sklex -c conda-forge --override-channels scikit-learn-intelex
+  conda activate sklex
 
-         * - Operating systems
-           - Windows*, Linux*
-         * - Python versions
-           - 3.10, 3.11, 3.12, 3.13, 3.14
-         * - Devices
-           - CPU, GPU
-         * - Modes
-           - Single, SPMD (Linux* only)
+To install in an existing environment: ::
 
+  conda install -c conda-forge --override-channels scikit-learn-intelex
 
-   .. tab:: Conda-Forge channel
+.. tip:: Running on GPU involves additional dependencies, see :doc:`oneapi-gpu`.  SPMD mode has additional requirements on top of GPU ones, see :doc:`distributed-mode` for details.
 
-      To install in a fresh environment: ::
+.. hint::
+  It is advisable to use the `miniforge <https://github.com/conda-forge/miniforge>`__ installer for ``conda``/``mamba``, as it comes with
+  ``conda-forge`` as the default channel.
 
-        conda create -n sklex -c conda-forge --override-channels scikit-learn-intelex
-        conda activate sklex
+.. warning::
+  The main Anaconda channel also provides distributions of ``scikit-learn-intelex``, but it does not provide the latest versions, nor does
+  it provide GPU-enabled builds. It is highly recommended to install ``scikit-learn-intelex`` from either conda-forge or from Intel's channel instead.
 
-      To install in an existing environment: ::
+.. list-table:: **Supported Configurations**
+   :align: left
 
-        conda install -c conda-forge --override-channels scikit-learn-intelex
+   * - Operating systems
+     - Windows*, Linux*
+   * - Python versions
+     - 3.10, 3.11, 3.12, 3.13, 3.14
+   * - Devices
+     - CPU, GPU
+   * - Modes
+     - Single, SPMD (Linux* only)
 
-      .. list-table:: **Supported Configurations**
-         :align: left
+.. note:: Packages are only available for x86-64 architecture.
 
-         * - Operating systems
-           - Windows*, Linux*
-         * - Python versions
-           - 3.10, 3.11, 3.12, 3.13, 3.14
-         * - Devices
-           - CPU, GPU
-         * - Modes
-           - Single, SPMD (Linux* only)
+.. tip::
 
-.. tip:: Running on GPU involves additional dependencies, see :doc:`oneapi-gpu`.  SPMD mode has additional requirements on top of GPU ones, see :doc:`distributed-mode` for details.
+  The |sklearnex| is also available at Intel's conda channel: ``https://software.repos.intel.com/python/conda``
 
-.. note:: Packages are only available for x86-64 architecture.
+  Packages from the Intel channel, which include also optimized versions of NumPy and SciPy, are meant to be used together with
+  dependencies from the **conda-forge** channel, and might not work correctly when used in an environment where packages from the
+  ``anaconda`` default channel have been installed.
 
 .. _build-from-sources:
 
-Build from Sources
-**********************
-
-See :doc:`building-from-source` for details.
+Building from Sources
+*********************
 
-Install Intel*(R) AI Tools
-****************************
+The |sklearnex| is a fully open-source package (`link to source code <https://github.com/uxlfoundation/scikit-learn-intelex>`_) which
+can be compiled from source with standard compiler toolkits.
 
-Download the Intel AI Tools `here <https://www.intel.com/content/www/us/en/developer/tools/oneapi/ai-tools-selector.html>`_. The extension is already included.
+See :doc:`building-from-source` for details.
 
 Release Notes
 -------------------