s3-school · vuillaut · Jan 28, 2026 · Jan 28, 2026 · Jan 28, 2026 · Jan 28, 2026
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -29,6 +29,12 @@ jobs:
         with:
           pixi-version: v0.63.1
 
+      - name: Install texlive
+        run: |
+          pixi run pip install install-texlive
+          pixi run install_texlive -p $HOME/.local/texlive -t 2024 --collections="-a" --package-file=paper/tex-packages.txt --update
+          echo "$HOME/.local/texlive/2024/bin/x86_64-linux" >> $GITHUB_PATH
+
       - name: Build documentation with Sphinx
         run: pixi run -e sphinx-doc sphinx-html
 

diff --git a/.github/workflows/paper.yml b/.github/workflows/paper.yml
@@ -28,7 +28,7 @@ jobs:
         echo "$HOME/.local/texlive/2024/bin/x86_64-linux" >> $GITHUB_PATH
 
     - name: Build Paper
-      run: pixi run paper
+      run: pixi run -e prod paper
 
     - uses: actions/upload-artifact@v6
       with:

diff --git a/docs/conf.py b/docs/conf.py
@@ -44,6 +44,9 @@
 html_theme = "sphinx_rtd_theme"
 html_static_path = ["_static"]
 
+# Copy additional files (paper PDF) to the build directory
+html_extra_path = ["../build/paper.pdf"]
+
 # nbsphinx configuration - execute notebooks during documentation build
 nbsphinx_execute = "always"
 nbsphinx_kernel_name = "python3"
diff --git a/docs/index.rst b/docs/index.rst
@@ -8,4 +8,5 @@
 
    readme
    analysis
+   paper
    modules
diff --git a/docs/paper.rst b/docs/paper.rst
@@ -0,0 +1,21 @@
+Paper
+=====
+
+The research paper describing the PKoffee project and its findings is available for download:
+
+* :download:`Download PDF <../build/paper.pdf>`
+
+Abstract
+--------
+
+Coffee consumption is often associated with productivity gains in software
+engineering, as productivity is multi-dimensional and influenced by task complexity,
+individual differences, and environmental factors. This study investigates the
+relationship between coffee consumption and developer productivity through a controlled
+observational study conducted over six months in a software engineering laboratory
+with 40 participants.
+
+Developer participants self-reported coffee consumption data throughout their
+development sessions, while their development activity and defect-related events were
+automatically logged via instrumented IDEs. Results indicate a complex, nonlinear
+relationship between coffee intake and productivity metrics.
-Original file line number
+Diff line change
@@ Expand Up / @@ -8,4 +8,5 @@ @@
        readme
        analysis
+       paper
        modules