1  Introduction

This section introduces the ARTE: Article Reproducibility Template & Environment. This is not an introduction to a research topic, but rather an explanation of the template’s purpose and structure.

This template is designed for researchers, particularly in the applied social sciences, who want to create dynamic and reproducible research articles. It aims to make the principles of reproducible research more accessible by providing a pre-structured project environment.

The template integrates several key tools and practices:

• Quarto’s book: For authoring dynamic documents that seamlessly blend narrative text, executable code (R), and the resulting outputs (tables, figures). This document you are reading is an example of a Quarto book.

• TIER Protocol 4.0: Provides a standardized folder structure (Data/, Scripts/, Output/) to organize your project logically and transparently, making it easier for others (and your future self) to understand and reproduce your work.

• Git/GitHub: Built-in version control allows you to track changes to your project over time, facilitating collaboration and providing a history of your work.

• Environment Control: The template supports three levels of environment management:

  • Proper Reproducibility: Using the R renv package to snapshot and restore specific versions of R packages.
  • Full Reproducibility (Recommended): Using Docker (see docker/ folder) to containerize the entire computational environment (R, RStudio, Quarto, packages, LaTeX). This ensures that your project runs identically on any machine with Docker installed, eliminating “it works on my machine” issues.

• GitHub Pages: Pre-configured for publishing your dynamic article using GitHub Actions (.github/workflows/deploy.yml) and designed for sharing on the Open Science Framework (OSF).

This example document demonstrates how these components work together. Gain some additional knowledge regarding Open Science and Reproducible Research (Kathawalla et al., 2021; Klein et al., 2018; Limongi & Rogers, 2025a, 2025b; Rogers & Limongi, 2025).

This is an example of how to integrate an external document into your article (Figure 1.1), showcasing the TIER Protocol 4.0 folder structure.

Figure 1.1: ARTE (Article Reproducibility Template & Environment) workflow folder structure. Illustration available at: https://doi.org/10.5281/zenodo.16748763

For more details about TIER Protocol 4.0, visit the page: https://www.projecttier.org/ and/or read the Domingos & Batista (2021) article.

Read the README files for the project root and explore the repository structure to learn more about how this protocol works with this template.

Domingos, A., & Batista, I. R. (2021). A map for transparency and replicability in empirical social science: the TIER Protocol. Revista Política Hoje, 40–86. https://doi.org/10.51359/1808-8708.2021.245776

Kathawalla, U.-K., Silverstein, P., & Syed, M. (2021). Easing Into Open Science: A Guide for Graduate Students and Their Advisors. Collabra: Psychology, 7(1), 18684. https://doi.org/10.1525/collabra.18684

Klein, O., Hardwicke, T. E., Aust, F., Breuer, J., Danielsson, H., Mohr, A. H., IJzerman, H., Nilsonne, G., Vanpaemel, W., & Frank, M. C. (2018). A Practical Guide for Transparency in Psychological Science. Collabra: Psychology, 4(1), 20. https://doi.org/10.1525/collabra.158

Limongi, R., & Rogers, P. (2025a). Open Science in Three Acts: Foundations, Practice, and Implementation - First Act. BAR - Brazilian Administration Review, 22(1), e250079. https://doi.org/10.1590/1807-7692bar2025250079

Limongi, R., & Rogers, P. (2025b). Open Science in Three Acts: Foundations, Practice, and Implementation - Second Act. BAR - Brazilian Administration Review, 22(2), e250116. https://doi.org/10.1590/1807-7692bar2025250116

Rogers, P., & Limongi, R. (2025). Open Science in Three Acts: Foundations, Practice, and Implementation - Third Act. BAR - Brazilian Administration Review, 22(3), e250162. https://doi.org/10.1590/1807-7692bar2025250162