hegsrr/hegsrr-manual

Manual for reproducibility and replicability with the HEGSRR-Template

hegsrr-manual's Issues

Proofread section on why to use Git

@doabell Can you proofread and suggest any important revisions to the provocation chapter section on why to use Git?
Also, in case people do run into situations where they have to manage merge conflicts, can you suggest a good reference or tutorial on doing that?

osf test site

https://test.osf.io/

mention this exists for practice using OSF features without committing anything to the real archive.

Migrate to Quarto

Quarto https://quarto.org/

General reasons:

• Quarto supersedes bookdown and similar packages. While bookdown still works, new functionality will happen in Quarto.
• Quarto is independent of R, so no need to install R
• Better functionality, for example Shiny or Jupyter chunk options
• Better documentation, has a folder structure

Reasons specific to this project:

• Quarto is a publishing system that can run R and Python
• Good demonstration of building out a website / book out of one's project, using .Rmd or .ipynb files

add info about when/why to use the 00-Python-environment-setup.ipynb script

@doabell , can you add a bit about this 00-Python-environment-setup.ipynb script to the environment python section of the ideation chapter?

Analagous work

• Berkeley transparency in the social sciences Social Science Reproduction Platform (SSRP) manual: https://bitss.github.io/ACRE/
• Project TIER: https://www.projecttier.org/

proofreading and filling gaps

@Peter-Kedron : please

• proofread the complete sections
• add short intro with the R&R framework and 2*2 matrix
• consider adding to / defining the archetypal study designs