add exp/resources description in generalities

doc/generalities.rst

@@ -52,14 +52,16 @@ Every Team has one or several Admin, who can change many settings affecting user
 
 Teams are created by the Sysadmin from the Sysconfig page (:ref:`see documentation <configure-teams>`).
 
-Entities and permissions
-========================
+Experiments and Resources
+=========================
 
-An Entity is an entry, which can be an Experiment, a Resource or an experiment Template.
+There are two main types of records that exist: **Experiments** and **Resources**. They are listed in their corresponding page, accessible from the main top menu.
 
-By default, Experiments and Resources are restricted to a team. But users can choose to extend this to all registered users or even anonymous users if enabled by the Sysadmin.
+**Experiments** are the main aspect of the ELN: it is where users log their results.
 
-Experiments belong to a user (owner), while Resources are common to the team and can be edited by anyone from the team (with default permissions).
+**Resources** correspond to a repository of *things* present in the lab, generally physical things, such as plasmids, equipment, antibodies, chemical products, etc... They have different properties than experiments, although both objects are similar in many aspects. A Resource can be made bookable (so they can be booked in the Scheduler) or procurable (so we can order more of it).
+
+By default, Experiments and Resources are restricted to a team. But users can choose to extend this to all registered users or even anonymous users if enabled by the Sysadmin. An extensive fine-grained permission system is available for both types of records and their corresponding templates to have complete control on who get to read/write what.
 
 User accounts
 =============

requirements.txt

@@ -1,3 +1,3 @@
-sphinx==6.1.3
-sphinx_rtd_theme==1.2.0rc3
+sphinx==8.1.3
+sphinx_rtd_theme==3.0.2
 sphinxcontrib-jquery