luciorq / bookclub-rpkgs

R4DS R Packages Book Club

A weekly reading group of R Packages by Hadley Wickham and Jennifer Bryan (2nd ed, WIP). Over the course of this book club, each member is going to start their own package!

Visit the #book_club-r_packages channel on Slack to join the video chat!

This repo contains 2 main folders:

• Presentations: each week a presenter will give a talk summarizing the chapter(s) and/or discussing practical applications of the topic at hand.
• Companion: A Bookdown site outlining learning objectives and collecting questions and answers on the chapters that come up during meetings (or between!)

Other useful links:

• CRAN's Writing R Extensions
• Book Club repo navigation: GitHub Web Editor | GitHub Local Setup

Meeting Schedule/Reading Order

(Order/schedule/groupings may be subject to change and will be confirmed a week in advance!)

Don't forget to check out the Learning Objectives for each week!

There are no active cohorts for this book.

Presentations & Recordings

1: Why should I read this book? Chapters 1 ("Introduction") & 2 ("The whole game"); Club goals overview

• Cohort 1 - Jon Harmon: slides | video

2: How do I set up my system and get started? Chapters 3 ("System setup") & 4 ("Package structure and state")

• Cohort 1 - Asmae Toumi: slides | video

3: How should I work on my package? Chapters 5 ("Fundamental development workflows") & 18 ("Git and GitHub")

• Cohort 1 - Tan Ho: slides | video

4: How do I convert a script to a package? Chapters 6 ("The package within") & 11 ("Vignettes: long-form documentation")

• Cohort 1 - Jon Harmon: slides | video | {within}

5: How do I write functions and document them? (introduction) Chapters 7 ("R code"), 10 ("Object documentation"), & 13 ("Namespace")

• Cohort 1 - Jon Leslie: slides | video

6: How do I write functions and document them? (names) Continued discussions of chapters 7, 10, and 13

• Cohort 1 - Jon Harmon: video

7: How do I make sure my package works? Chapters 12 ("Testing") & 19 ("Automated checking")

• Cohort 1 - David Edison: slides | video | demo package tests

8: How do I make sure my package works? Continuous Integration/GitHub Actions

• Cohort 1 - Yoni Sidi: slides | video | repo

9: What am I working on? Discussions of member projects

• Cohort 1 - video

10: How do I describe my package? Chapters 8 ("Package metadata") & 9 ("Licensing")

• Cohort 1 - Tony ElHabr: slides | video

11: How do I include things like data and do obscure package-y things? Chapters 14 ("External data"), 15 ("Compiled code"), 16 ("Installed files"), and 17 ("Other components")

• Cohort 1 - Jon Harmon: slides | video

12: How do I share and promote my package? Chapter 20 ("Releasing a package") & Marketing/pkgdown

• Cohort 1 - Asmae Toumi: SLIDES | video