Reproducibility + organization
Project 01
All written work should be reproducible, and the GitHub repo should be neatly organized.
- Points for reproducibility + organization will be based on the reproducibility of the entire repository and the organization of the project GitHub repo.
- The repo should be neatly organized as described above, there should be no extraneous files, all text in the README should be easily readable.
TipThe easiest way to ensure reproducibility
Have a team member clone the repository to a new location (on Posit Workbench or their local machine), install required packages as specified in the lockfiles (renv::restore()
for R, uv sync
for Python), and try to render all Quarto files and run any R/Python scripts. If everything runs without error, your project is (likely) reproducible!
Evaluation criteria
Category | Less developed projects | Typical projects |
---|---|---|
Reproducibility (code) | Required files are missing. Quarto files do not render successfully (except for if a package needs to be installed). | All required files are provided. Project files (e.g. Quarto, Shiny apps, R/Python scripts) render without issues and reproduce the necessary outputs. |
Reproducibility (packages) | renv.lock and/or uv.lock files do not include all required packages. External users have to manually install packages in order to get code to evaluate. |
renv.lock and/or uv.lock files include all required packages. Manual package installation is not required to render any code in the repo (e.g. Quarto documents, R/Python scripts). |
Data documentation | Codebook is missing. No local copies of data files. | All datasets are stored in a data folder, a codebook is provided, and a local copy of the data file is used in the code where needed. |
File organization/readability | Documents lack a clear structure. There are extraneous materials in the repo and/or files are not clearly organized. | Documents (Quarto files and R scripts) are well structured and easy to follow. No extraneous materials. |