Version bump of the packages + minor updates

CONTRIBUTING.md

@@ -80,7 +80,6 @@ sphinx-build -b html . build
 
 Start a web server to host the generated files from `build` directory
 ```bash
-cd build
 python -m http.server -d build
 ```
 

fast-sim-and-analysis/FccFastSimVertexing/Readme.md

@@ -1,8 +1,7 @@
 # Tracking and vertexing example using specific flavour decays
 
 >
-> Original authors: Emmanuel Francois Perez, Clement Helsens  
-> Edited by: Juraj Smiesko
+> Original authors: Emmanuel Francois Perez, Clement Helsens
 >
 
 

fast-sim-and-analysis/k4simdelphes/doc/starterkit/FccFastSimDelphes/Readme.md

@@ -113,12 +113,21 @@ DelphesPythia8_EDM4HEP card_IDEA.tcl edm4hep_IDEA.tcl p8_ee_WW_ecm240.cmd p8_ee_
 
 ## Sample Generation: Pythia8 + EvtGen
 
-Author: Vasilisa Guliaeva
-
-
-This part explains how to produce FCC-ee samples with **Pythia8** and [**EvtGen**](https://evtgen.hepforge.org), using the standard FCC configuration files and **EDM4hep** output format. 
-
-**EvtGen** is a decay generator specialized in the simulation of hadronic decays of heavy-flavour particles with accurate angular correlations and form-factor models. **EvtGen** is interfaced to [**Pythia8**](https://github.com/HEP-FCC/k4Gen/blob/main/k4Gen/src/components/PythiaInterface.h#L88-L97) through **k4Gen**, so that events generated by **Pythia** can be decayed by **EvtGen** before detector simulation.
+>
+> Author: Vasilisa Guliaeva
+>
+
+This part explains how to produce FCC-ee samples with
+[**Pythia8**](https://pythia.org/) and
+[**EvtGen**](https://evtgen.hepforge.org), using the standard FCC configuration
+files and **EDM4hep** output format.
+
+[**EvtGen**](https://evtgen.hepforge.org/) is a decay generator specialized in
+the simulation of hadronic decays of heavy-flavour particles with accurate
+angular correlations and form-factor models. **EvtGen** is interfaced to
+[**Pythia8**](https://github.com/HEP-FCC/k4Gen/blob/main/k4Gen/src/components/PythiaInterface.h#L88-L97)
+through **k4Gen**, so that events generated by **Pythia** can be decayed by
+**EvtGen** before detector simulation.
 
 We will generate a Monte Carlo sample of 1'000 events, matching the `winter2023` MC campaign, for $e^{+} e^{-} \;\rightarrow\; Z \;\rightarrow\; b\bar{b} \;\rightarrow\; B^{+} \;\rightarrow\; \tau^{+} \nu_{\tau} \;\rightarrow\; 3\pi$. All standard configuration files for FCC-ee Monte Carlo campaigns are provided in the [FCC-config repository (winter2023 branch)](https://github.com/HEP-FCC/FCC-config/tree/winter2023).
 
@@ -133,8 +142,12 @@ Since the EDM4hep output card that maps Delphes collections into EDM4hep data st
 ```bash
 source /cvmfs/sw.hsf.org/spackages6/key4hep-stack/2022-12-23/x86_64-centos7-gcc11.2.0-opt/ll3gi/setup.sh
 ```
+
 **Event generation**
-To generate events with Pythia8 + EvtGen, use the executable `DelphesPythia8EvtGen_EDM4HEP_k4Interface`. Make sure your FCC software setup is actually working in correct enviroment. You can check this by running: 
+
+To generate events with Pythia8 + EvtGen, use the executable
+`DelphesPythia8EvtGen_EDM4HEP_k4Interface`. Make sure your shell environment is
+correctly set up by running:
 ```bash
 which DelphesPythia8EvtGen_EDM4HEP_k4Interface
 ```
@@ -143,11 +156,18 @@ For our stack output should be:
 /cvmfs/sw.hsf.org/spackages6/k4simdelphes/00-03-00/x86_64-centos7-gcc11.2.0-opt/pqqvt/bin/DelphesPythia8EvtGen_EDM4HEP_k4Interface
 ```
 
-The executable wrapper that connects Pythia8, EvtGen, and Delphes, and writes output in EDM4hep format. You can inspect its expected argument order by running:
+The executable wrapper that connects Pythia8, EvtGen, and Delphes, and writes
+output in EDM4hep format. You can inspect its expected argument order by
+running:
 ```bash
 DelphesPythia8EvtGen_EDM4HEP_k4Interface -h
 ```
-it will display  the following output:
+
+:::{admonition} `DelphesPythia8EvtGen_EDM4HEP_k4Interface` CLI arguments
+:class: callout toggle
+
+The `DelphesPythia8EvtGen_EDM4HEP_k4Interface` takes the following CLI
+arguments.
 
 ```
 Usage: DelphesPythia8EvtGenconfig_file output_config_file pythia_card output_file DECAY.DEC evt.pdl user.dec
@@ -160,6 +180,7 @@ DECAY.DEC - EvtGen full decay file,
 evt.pdl - EvtGen particle list,  
 user.dec - EvtGen user decay file.
 ```
+:::
 
 To start the sample generation, we need to download the configuration files.
 

requirements.txt

@@ -1,6 +1,6 @@
-Sphinx==7.3.7
-myst-parser==3.0.0
-sphinx-rtd-theme==2.0.0
+Sphinx==7.4.7
+myst-parser==3.0.1
+sphinx-rtd-theme==3.0.2
 sphinx-togglebutton==0.3.2
 sphinx-copybutton==0.5.2
 sphinx-multiversion==0.2.4