Merge pull request festim-dev#872 from rekomodo/wsl_instructions

added WSL and Anaconda instructions

docs/source/installation.rst

@@ -2,17 +2,42 @@
 Installation
 ============
 
+FESTIM is installed in two steps:
+    1. `Installing FEniCS`_ through Anaconda or Docker
+    2. `Installing FESTIM`_ through pip on the FEniCS environment
+
 Installing FEniCS
 -----------------
 
-FESTIM requires FEniCS to run.
-
 FEniCS can be installed with Anaconda on MacOs and Linux. 
-In order to use the Anaconda distribution on Windows, use the `Windows Subsystem for Linux <https://learn.microsoft.com/en-us/windows/wsl/install>`_. 
-First `install Anaconda <https://docs.continuum.io/anaconda/install>`_ then run the following commands::
+In order to use the Anaconda distribution on Windows, 
+use the `Windows Subsystem for Linux <https://learn.microsoft.com/en-us/windows/wsl/install>`_. 
+
+.. tip::
+    You can install `WSL <https://learn.microsoft.com/en-us/windows/wsl/install>`_ by running
+    :code:`wsl --install` on a command prompt window.
+    To launch into WSL, simply enter :code:`wsl`.
+
+    `Visual Studio Code <https://code.visualstudio.com/>`_ is the recommended IDE to 
+    use with Windows due to the 
+    `WSL extension <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl>`_.
+
+First `install Anaconda <https://docs.continuum.io/anaconda/install>`_,
+
+.. tip::
+
+    You can install Anaconda on most Linux distributions by entering::
+
+        curl -O https://repo.anaconda.com/archive/Anaconda3-2024.06-1-Linux-x86_64.sh
+        bash ./Anaconda3-2024.06-1-Linux-x86_64.sh
+
+    You can install other versions by replacing :code:`Anaconda3-2024.06-1-Linux-x86_64.sh` 
+    with another from `the official repository <https://repo.anaconda.com/archive/>`_.
+
+then run the following commands::
 
     conda create -n festim-env
-    conda activate festim-env
+    conda activate festim-env       
     conda install -c conda-forge fenics numpy=1.24
 
 Alternatively, It can be installed using `Docker <https://www.docker.com/>`_::