Welcome to the DSLC Outstanding User Interfaces with Shiny Book Club!
We are working together to read Outstanding User Interfaces with Shiny by David Granjon (Chapman & Hall, copyright August 31, 2022, 9780367645267). Join the #book_club-shinyui channel on the DSLC Slack to participate. As we read, we are producing notes about the book.
If you would like to present, please see the sign-up sheet for your cohort (linked below, and pinned in the #book_club-shinyui channel on Slack)!
- Cohort 1 (started 2023-02-14, finished 2023-10-03): meeting videos
- Cohort 2 (started 2024-11-08, finished 2025-11-07): meeting videos
This repository is structured as a {bookdown} site. To present, follow these instructions:
Do these steps once:
- Setup Git and GitHub to work with RStudio (click through for detailed, step-by-step instructions; I recommend checking this out even if you're pretty sure you're all set).
usethis::create_from_github("r4ds/bookclub-shinyui")(cleanly creates your own copy of this repository).
Do these steps each time you present another chapter:
- Open your project for this book.
usethis::pr_init("my-chapter")(creates a branch for your work, to avoid confusion, making sure that you have the latest changes from other contributors; replacemy-chapterwith a descriptive name, ideally).devtools::install_dev_deps()(installs any packages used by the book that you don't already have installed).- Edit the appropriate chapter file, if necessary. Use
##to indicate new slides (new sections). - If you use any packages that are not already in the
DESCRIPTION, add them. You can useusethis::use_package("myCoolPackage")to add them quickly! - Build the book! ctrl-shift-b (or command-shift-b) will render the full book, or ctrl-shift-k (command-shift-k) to render just your slide. Please do this to make sure it works before you push your changes up to the main repo!
- Commit your changes (either through the command line or using Rstudio's Git tab).
usethis::pr_push()(pushes the changes up to github, and opens a "pull request" (PR) to let us know your work is ready).- (If we request changes, make them)
- When your PR has been accepted ("merged"),
usethis::pr_finish()to close out your branch and prepare your local repository for future work. - Now that your local copy is up-to-date with the main repo, you need to update your remote fork. Run
gert::git_push("origin")or click thePushbutton on theGittab of Rstudio.
When your PR is checked into the main branch, the bookdown site will rebuild, adding your slides to this site.