This repository contains materials for the 5-day workshop Better Code, Better Science: Next Steps in R & Python Practices, taught by Tuan Nguyen on April 13-17, 2026.
This workshop combines discussion and hands-on practice focused on improving code in R and Python. The repository is organized by day so that notes, activities, and language-specific materials stay grouped together.
By the end of the workshop, participants will be able to:
- Write clear, readable, and well-documented code.
- Refactor repeated code into reusable functions.
- Build more reproducible workflows.
- Review code critically and test important logic.
- Organize work so it is easier to share with others.
.
|-- documents/
| |-- syllabus.md
| |-- activity-breakdown.md
| `-- slides/
|-- teaching/
`-- modules/
|-- day-01-readable/
|-- day-02-reusable/
|-- day-03-reproducible/
|-- day-04-reliable/
`-- day-05-shareable/
Within each day:
day-0x-...
|-- agenda.md
|-- activities/
| |-- activity-1/
| `-- activity-2/
`-- demos/
documents/: course-wide materials, including the syllabus, activity breakdown, and shared slide filesteaching/: instructor-facing notes grouped by daymodules/: one folder for each workshop day
Within each day:
agenda.md: the day schedule and flowactivities/: learner prompts and activity-specific materialsdemos/: short demo materials and worked examples used during teaching
Start with the materials in documents/ for the overall course structure. Then use the relevant folder in modules/ for each day's learner-facing agenda and activities. If you are teaching the workshop, use teaching/ for instructor-facing notes and facilitation guidance.