Skip to content

ARTE v2.1

Latest
Latest

Choose a tag to compare

View all tags
@phdpablo phdpablo released this 19 Jan 18:01
v2.1
b896e47
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

ARTE v2.1.0 Release Notes

We are pleased to announce the release of ARTE (Article Reproducibility Template & Environment) v2.1.0!

This release introduces cloud-based reproducibility verification via MyBinder, significantly improves the GitHub Actions deployment workflow, and updates key dependencies including a major ggplot2 upgrade.

✨ Key Features

Cloud-Based Reproducibility Verification (MyBinder)

  • New MyBinder integration allows anyone to verify the computational workflow without local installation
  • One-click browser-based access to a complete R/RStudio/Quarto environment
  • New .binder/ folder with:
    • Custom Dockerfile based on rocker/binder: 4.4.2
    • Comprehensive README.md with step-by-step instructions
  • Ephemeral environment ideal for reproducibility verification and exploration

Optimized GitHub Actions Workflow

  • Intelligent caching for TinyTeX, Quarto, and R packages significantly reduces build times
  • Integration with r-lib/actions/setup-renv@v2 for automatic package restoration from renv.lock
  • Switched from full TeX Live to lightweight TinyTeX installation
  • Added GITHUB_PAT environment variable for authenticated operations
  • Updated documentation for gh-pages branch setup

Docker Improvements

  • New texlive_data volume for persistent LaTeX distribution across container recreations
  • Added tlmgr update step before installing LaTeX packages
  • Additional LaTeX packages: pgf, environ, pdfcol, fontawesome5, tcolorbox
  • Simplified Dockerfile by removing redundant renv setup

📦 Dependency Updates

Major Updates

  • ggplot2: 3.5.2 → 4.0.1 (major version upgrade with S7 OOP system)
  • renv: 1.1.4 → 1.1.5

New Dependencies

  • S7: New object-oriented programming system (required by ggplot2 4.x)
  • cpp11: C++11 interface for R

Streamlined Dependencies

  • Removed non-essential packages from renv.lock: MASS, Matrix, mgcv, nlme, lattice, tibble, pillar, magrittr, pkgconfig, utf8
  • Leaner dependency tree improves installation times and reduces potential conflicts

📝 Documentation Enhancements

New Content

  • Video tutorials added to the homepage:
    • English presentation video
    • Portuguese tutorial for Brazilian audience
  • MyBinder sections added throughout the article (Introduction, Background, Methods, Results, Conclusion)
  • Conceptual summary link to the three BAR editorials
  • Course reference for Portuguese speakers

Updated Resources

  • Updated Zenodo DOI links for ARTE workflow illustrations
  • Refreshed figures: arte-folders.jpg, roadmap1.jpg, roadmap2.jpg
  • Updated references.bib with complete volume/number information

Improved Instructions

  • Clearer GitHub Pages deployment instructions
  • Added note about creating gh-pages branch if it doesn't exist
  • Updated workflow README with better formatting

⚙️ Configuration Changes

Quarto Configuration (_quarto.yml)

  • Added freeze: auto for automatic code execution management based on source changes
  • Changed default editor from visual to source mode

Git Configuration

  • Added _freeze/ to .gitignore

🔗 Resources

📚 Citation

If you use this template, please cite:

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

We hope ARTE v2.1.0 makes reproducible research even more accessible by enabling cloud-based verification alongside local Docker environments.

Assets 2
Loading