Fill introduction of the documentation

.chktexrc

@@ -0,0 +1,16 @@
+
+# in the base directory of your project
+
+QuoteStyle = Traditional
+
+VerbEnvir
+{
+    verbatim comment listing verbatimtab rawhtml errexam picture texdraw
+    filecontents pgfpicture tikzpicture minted lstlisting texttt
+    solution
+}
+
+CmdLine
+{
+    --nowarn 1 --nowarn 8 --nowarn 13
+}

.github/workflows/lint.yml

@@ -0,0 +1,22 @@
+# in .github/workflows/lint.yml
+
+name: Lint
+
+on: 
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@master
+    - name: LaTeX linter (chktex)
+      uses: j2kun/chktex-action@main
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -9,3 +9,5 @@
 *.xml
 *.DS_STORE
 *.txss2
+*.lof
+*.lot

.vscode/settings.json

@@ -0,0 +1,22 @@
+{
+    "workbench.colorCustomizations": {
+        "activityBar.activeBackground": "#f181b2",
+        "activityBar.background": "#f181b2",
+        "activityBar.foreground": "#15202b",
+        "activityBar.inactiveForeground": "#15202b99",
+        "activityBarBadge.background": "#caf5a9",
+        "activityBarBadge.foreground": "#15202b",
+        "commandCenter.border": "#15202b99",
+        "sash.hoverBorder": "#f181b2",
+        "statusBar.background": "#ec5396",
+        "statusBar.foreground": "#15202b",
+        "statusBarItem.hoverBackground": "#e7257a",
+        "statusBarItem.remoteBackground": "#ec5396",
+        "statusBarItem.remoteForeground": "#15202b",
+        "titleBar.activeBackground": "#ec5396",
+        "titleBar.activeForeground": "#15202b",
+        "titleBar.inactiveBackground": "#ec539699",
+        "titleBar.inactiveForeground": "#15202b99"
+    },
+    "peacock.color": "#ec5396"
+}

chapters/exercise.tex

@@ -1,21 +1,6 @@
-\chapter{$H \rightarrow ZZ \rightarrow 4l$}
-\justifying
-\paragraph{}
-The goal of this exercise is to reconstruct the Standard Model (SM) Higgs boson mass, using a selection targeting the four-lepton final state. This is considered a \textit{golden} channel to rediscovered the Higgs because:
-\begin{itemize}
-    \item there is a \textbf{\underline{ large signal to background ratio}} -- it is easy to discriminate between the peak of the reconstructed four-lepton mass ($m_{4l}$) and the overall flat background shape; 
-    \item we have excellent \textbf{\underline{ mass resolution}} -- thanks to the great resolution power of CMS, we have optimal shape reconstruction of $m_{4l}$;
-    \item it is a \textbf{\underline{ resolved final state}} -- detection of the four leptons in the final state ensures good discrimination of signal and background.
-\end{itemize}
-
-\begin{figure}[!h]
-    \centering
-    \includegraphics[scale=0.35]{images/plot.png}
-    \caption{\justifying{Reconstructed four-lepton invariant mass $m_{4l}$ with 2018 data. The SM Higgs boson signal with $m_H = 125$ GeV, denoted as $H(125)$, and the $ZZ$ backgrounds are normalized to the SM expectation. The $Z+X$ background is normalized to the estimation from data.}}
-    \label{higgs_plot}
-\end{figure}
-
-\include{sections/setup}
-\include{sections/strategy}
+\include{sections/taskarrayfunctions}
 \include{sections/calibrator}
 \include{sections/selector}
+\include{sections/producer}
+\include{sections/categorizer}
+\include{sections/inference}

chapters/intro.tex

@@ -1,19 +1,5 @@
-\chapter{Introduction to ColumnFlow}
+\include{sections/general_intro}
+\include{sections/goal}
+\include{sections/setup}
+\include{sections/strategy}
 
-ColumnFlow is intended as a back-end for analyses in order to facilitate processing large amounts of data.
-It is purely python-based and employs multiple packages that are well-received and {-maintained} in the HEP community.
-At the time of writing these instructions, the team of developer's purely consists of data analysts at the CMS experiment.
-Therefore, this exercise is structured accordingly.
-Please note that ColumnFlow is in principle designed in an experiment-agnostic way, such that it can also be extended to other use cases.
-
-Additionally, please note that this hands-on exercise is not meant to fully document all available functionalities.
-The purpose of this exercise is to give an overview of the most fundamental aspects and concepts that are available at the time of writing.
-For a more comprehensive overview, please visit the \href{https://columnflow.readthedocs.io/en/latest/}{official documentation}. % might want to put this as a proper reference
-In case of any questions are comments, feel free to contact the maintainers for example via the \href{https://github.com/columnflow/columnflow}{git repository}.
-
-\begin{figure}[p]
-	\centering
-	\includegraphics[scale=0.8]{images/CF_tasks.png}
-	\caption{\justifying{ColumnFlow task graph hierarchy}}
-	\label{fig:task_graph}
-\end{figure}