2  Background


This section provides background on the concepts of reproducibility and the tools integrated into this template.

Reproducible research is a cornerstone of good scientific practice. It ensures that findings are reliable and that the scientific process is transparent. The tools and structure provided by this template are designed to support these principles.

Make sure to look into the thought of reproducible research practice (Dogucu & Çetinkaya-Rundel, 2022; Gilroy & Kaplan, 2019; Limongi & Rogers, 2025a, 2025b; Rogers & Limongi, 2025; Sullivan et al., 2019; Vuorre & Curley, 2018; Wiebels & Moreau, 2021; Wilson et al., 2017).

2.1 Reproducibility Levels

The template is designed to support different levels of reproducibility, as illustrated in the Figure 2.1. The levels are:

  • Minimal Reproducibility: Using the template structure, editing READMEs, and sharing on OSF.
  • Proper Reproducibility: Adding Quarto narrative (with RStudio and Git/GitHub) development and using renv package for R package management.
  • Full Reproducibility (This Template’s Strength): Incorporating Docker to containerize the entire computational environment, ensuring maximum consistency and ease of replication. This is achieved using the files in the docker/ folder.
Figure 2.1: Roadmap for Developing a Dynamic and Reproducible Research Article with ARTE workflow. Illustration available at: https://doi.org/10.5281/zenodo.16883797

2.2 The Role of Dynamic Documents

Dynamic documents, like the ones created with Quarto (.qmd files), play a crucial role. They allow the narrative of your research to be directly linked to the analysis code. When you render the document, the code is executed, and the results (tables, figures, numbers) are automatically inserted into the text. This reduces manual errors and ensures that your narrative always reflects the latest analysis.

2.3 TIER Protocol 4.0 Structure

The folder structure adheres to the TIER Protocol 4.0:

  • Data/: Stores raw, intermediate, and final data files.
  • Scripts/: Contains R scripts for data processing, analysis, and visualization. Complex analyses are best kept here.
  • Output/: Stores generated results like tables, figures, and intermediate data files.
  • docs/ (Root): Contains the final rendered output (HTML, PDF) for web publication.
  • Root: Contains main narrative files (index.qmd, 01-intro.qmd, etc.), project configuration (_quarto.yml), bibliography (references.bib), and CSL style file (apa7ed.csl).

This structure promotes clarity and makes it easier for others to navigate your project.