JADE-V-V · dodu94 · Mar 30, 2026 · Mar 30, 2026 · Mar 30, 2026 · Mar 30, 2026
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
@@ -7,9 +7,9 @@ version: 2
 
 # Set the version of Python and other tools you might need
 build:
-  os: "ubuntu-20.04"
+  os: "ubuntu-lts-latest"
   tools:
-    python: "3.10"
+    python: "3.12"
     # You can also specify other tool versions:
     # nodejs: "16"
     # rust: "1.55"

diff --git a/docs/source/dev/futuredev.rst b/docs/source/dev/futuredev.rst
diff --git a/docs/source/documentation/benchmarks.rst b/docs/source/documentation/benchmarks.rst
@@ -15,6 +15,12 @@ benchmark in JADE.
     As explained in the :ref:`ecosystem` section, depending on their licensing
     policy, the benchmark inputs are stored in different GitHub/GitLab repositories.
 
+.. important::
+    For all FNG benchmarks in MCNP a SDEF source produced in 2021 by ENEA Frascati team (Davide Flammini et al.)
+    was used. The source is parametrized at 260 keV and was generated using the following rdum parameters:
+
+    "rdum    .260  1.6  0.0  0.001  0.0  0.001  1  1"
+
 Overview
 ========
 The following tables summarise the computational and experimental benchmarks

diff --git a/docs/source/nutshell.rst b/docs/source/nutshell.rst
@@ -47,10 +47,10 @@ When using JADE for scientific publications you are kindly encouraged to cite th
   2022, "Status of JADE, an open-source software for nuclear data libraries V&V",
   *Fusion Engineering and Design*, **187** 113380, doi: https://doi.org/10.1016/j.fusengdes.2022.113380
 
-For additional information contact: davide.laghi01@gmail.com
+For additional information contact: davide.laghi@f4e.europa.eu or alex.valentine@ukaea.uk.
 
 For additional information on future developments please check the issues list on the
-`JADE GitHub repository <https://github.com/dodu94/JADE/>`_ and :ref:`futuredev`.
+`JADE GitHub repository <https://github.com/dodu94/JADE/>`_.
 
 .. seealso:: 
   * **MCNP**, Werner C.J., 2017, "MCNP User’S Manual Code", Los Alamos: LAUR-17-29981 (version 6.2).

diff --git a/docs/source/usage/troubleshooting.rst b/docs/source/usage/troubleshooting.rst
@@ -55,9 +55,30 @@ or
 
 you can solve the issue installing the following libraries:
 
-```
-conda install -c conda-forge libgl
-conda install -c conda-forge xorg-libxrender
-```
+.. code-block:: bash
+    conda install -c conda-forge libgl
+    conda install -c conda-forge xorg-libxrender
+
+
+ImportError: urllib3 v2 only supports OpenSSL 1.1.1+
+====================================================
+
+There are a few systems where the installation may fail while fetching the benchmark
+data from the internet due to old version installed of OpenSSL.
+The drop in support is described `here <https://github.com/urllib3/urllib3/issues/2168>`_.
+
+If this error is encountered either the openSSL can be upgraded:
+
+.. code-block:: bash
+
+    brew install openssl@1.1
+
+or the urllib3 version (jade dependency) can be downgraded:
+
+.. code-block:: bash
+
+    pip install urllib3==1.26.6
+
+see `here <https://stackoverflow.com/questions/76187256/importerror-urllib3-v2-0-only-supports-openssl-1-1-1-currently-the-ssl-modu>`_ for additional info on the fix.