Merge pull request #125 from DE-RSE/success-story-boxes

Make boxes around success stories

Author: knarrff

.github/workflows/paper.yml

@@ -21,17 +21,16 @@ jobs:
         run: pip install -r requirements.txt
 
       - name: Install LaTeX requirements for matplotlib
-        run: sudo apt install -y texlive-latex-base texlive-latex-extra cm-super-minimal texlive-fonts-extra
+        run: sudo apt install -y texlive-latex-base texlive-latex-extra cm-super-minimal texlive-fonts-extra latexmk texlive-bibtex-extra biber
 
       - name: Create contributor snippet
         run: python contributors.py
 
       - name: Create group composition plot
         run: cd group_composition_plot && ./create_paper_plots.sh && cd -
 
-      - uses: xu-cheng/latex-action@v3
-        with:
-          root_file: paper.tex
+      - name: Compile paper
+        run: latexmk -pdf --file-line-error --halt-on-error --interaction=nonstopmode --recorder paper.tex
 
       - name: move
         run: mkdir -p github_artifacts && mv ${{ env.DIR }}/*.pdf ./github_artifacts/ 

paper.tex

@@ -17,6 +17,8 @@
 \usepackage{xspace}
 \usepackage{caption,tikzpagenodes,ifthen}
 
+\usepackage{mdframed}
+
 \newcommand*{\eg}{e.\,g.\@\xspace}
 \newcommand*{\ie}{i.\,e.\@\xspace}
 
@@ -303,23 +305,14 @@ \subsection{Module 3: Development Services}%
 RSE units that offer development services at all scales have proven to be a success story at many research institutions and have rapidly grown in size due to the influx of third party funding.
 Notable examples~\autocite{Katz2019} are \eg{} Manchester~\autocite{Sinclair2022}, Notre-Dame~\autocite{NotreDame2025}, Stanford~\autocite{Stanford2025}, Princeton~\autocite{Princeton2025, Cosden2022a}.
 
-[SuccessStory]
-Founded in January 2017, the Research Computing department of Princeton University has experienced a tremendous growth from the initial two FTEs to a total of 18 FTEs in the span of five years~\autocite{Cosden2022a}.
-This growth is based on a continuous influx of new funded projects once successful projects showcase the additional value of RSE services to researchers.
-
-[Success Story]
-The University of Manchester Software and Data Science group has successfully established specialised development services within their institution:
-The “Mobile Development Service”~\autocite{manchester_mobile} team consists of RSEs that focus solely on developing and deploying mobile apps.
+\begin{mdframed}
+\textbf{Success Story:} The University of Manchester Software and Data Science group has successfully established specialised development services within their institution:
+The “Mobile Development Service” \autocite{manchester_mobile} team consists of RSEs that focus solely on developing and deploying mobile apps.
 Without a central RSE unit to anchor such specialised expertise, it would be difficult to establish such a service.
 Also, having this expertise centralised allows for synergies in the deployment procedure for mobile apps:
 The RSE unit can create institutional accounts with the app stores and manage the time consuming deployment process including hard-to-setup procedures like code signing.
 Besides the technical benefits of this central deployment procedure, the institution will also benefit from the increased visibility and potentially be able to build a brand with its technological output.
-
-[Success Story]
-The Scientific IT Services of ETH Zurich (SIS) started in 2013 with a handful of members and has (as of March 2024) around 50 members.
-In addition to HPC services, the group also offers RSE services in various areas.
-These include the development of software applications for RDM, support in the development and improvement of scientific software or the long-term maintenance of software developed in research groups.
-In addition, SIS offers services in the areas of data science, machine learning, bioinformatics, trusted compute environments, and training and consulting.
+\end{mdframed}
 
 \subsection{Module 4: Teaching Services}%
 \label{sec:teaching}
@@ -578,11 +571,22 @@ \subsubsection{Growth of the Department}
 We believe that the credibility of a research proposal that is asking for RSE funds is greatly enhanced if the RSE unit is part of this proposal from the beginning.
 Over time, more and more researchers and proposals are expected to follow the institutional policy such that a consistent stream of income can be generated.
 
+\begin{mdframed}
+\textbf{Success Story:} Founded in January 2017, the Research Computing department of Princeton University has experienced a tremendous growth from the initial two FTEs to a total of 18 FTEs in the span of five years~\autocite{Cosden2022a}.
+This growth is based on a continuous influx of new funded projects once successful projects showcase the additional value of RSE services to researchers.
+\end{mdframed}
+
 \paragraph{Offering of additional services}
 With the additionally acquired funds, the service portfolio of the RSE unit can be enhanced regarding the modules described in \autoref{sec:vision}.
 Obviously, the selection of modules and their share in the overall portfolio depend on the services that have been applied for in the corresponding proposals.
 As this is strongly connected to hiring persons with the required expertise, this has to be carefully planned, see also below.
 
+\begin{mdframed}
+\textbf{Success Story:} The Scientific IT Services of ETH Zurich (SIS) started in 2013 with a handful of members and has (as of March 2024) around 50 members.
+In addition to HPC services, the group also offers RSE services in various areas.
+These include the development of software applications for RDM, support in the development and improvement of scientific software or the long-term maintenance of software developed in research groups.
+In addition, SIS offers services in the areas of data science, machine learning, bioinformatics, trusted compute environments, and training and consulting.
+\end{mdframed}
 
 \subsection{Outsourcing}