commit 4edabe6d4596c682cde303cb60a34f575b406d90
parent f58b288ba1e990fe60b5eeaa814317fb9e3daed5
Author: Collin K. Berke, Ph.D <32435546+collinberke@users.noreply.github.com>
Date: Tue, 25 Oct 2022 11:14:28 -0700
Update intro materials (#32)
Diffstat:
2 files changed, 60 insertions(+), 10 deletions(-)
diff --git a/01_Introduction.Rmd b/01_Introduction.Rmd
@@ -7,6 +7,8 @@
- Improve programming skills.
- Develop a deep understanding of the R language fundamentals.
- Understand what functional programming means.
+- Understand object-oriented programming as applied in R.
+- Understand metaprogramming while developing in R.
**For this chapter (includes the Welcome and Preface):**
@@ -26,23 +28,31 @@ Books suggestions:
> "Use of new packages, particularly rlang, which provides a clean interface to low-level data structures and operations."
-
```{r, echo=FALSE,out.width="49%",out.height="49%",fig.show='hold',fig.align='center', fig.cap="Twitter: `@hadleywickham` - 6 June 2019"}
-
knitr::include_graphics(c("images/01-hadley-image1.jpeg","images/01-hadley-image2.jpeg"))
```
+## Overview of the book structure
+
+* The book is composed of five sections. A step by step path towards mastering R techniques.
+* The **Foundations** is the part in which the R components will be examined. It will help understanding how to use all the basics tools to deal with functions and structures.
+* The **Functional programming** goes a little more in dept into programming with R, making functions of functions. Describing function factories and operators.
+* The **Object-oriented programming** - OOP is a five chapter section, all about object oriented systems among S3, R6 and S4.
+* The **Metaprogramming** section introduces you through the programming layers.
+* Finally, the **Techniques** section is dedicated to finding and fixing bugs and improving performances.
+### What this book is not
-## Overview of the book structure
+* This book is about the R programming language, not R as the data analysis tool.
+ * Other books cover this topic.
+ * [R for Data Science](https://r4ds.had.co.nz/).
+* We will not be discussing package development at length.
+ * [R Packages](https://r-pkgs.org/).
+* Some experience using R will be helpful.
+ * I encourage all to participate, though.
-The book is composed of five sections. A step by step path towards mastering R techniques.
-The **Foundations** is the part in which the R components will be examined. It will help understanding how to use all the basics tools to deal with functions and structures.
-The **Functional programming** goes a little more in dept into programming with R, making functions of functions. Describing function factories and operators.
-The **Object-oriented programming** - OOP is a five chapter section, all about object oriented systems among S3, R6 and S4.
-The **Metaprogramming** section introduces you through the programming layers.
-Finally, the **Techniques** section is dedicated to finding and fixing bugs and improving performances.
+### Organization of the book
```{r dia-lib,include=FALSE}
library(DiagrammeR)
@@ -59,7 +69,6 @@ DiagrammeR("
```
</center>
-
### Foundations
Six chapters to learn the foundational components of R.
diff --git a/index.Rmd b/index.Rmd
@@ -38,9 +38,50 @@ This companion follows the [R4DS Online Learning Community Code of Conduct](http
- Presentations will usually consist of a review of the material, a discussion, and/or a demonstration of the principles presented in that chapter.
- More information about how to present is available in the [github repo](https://github.com/r4ds/bookclub-advr).
- Presentations will be recorded, and will be available on the [R4DS Online Learning Community YouTube Channel](https://r4ds.io/youtube).
+ - Camera is optional, but encouraged.
+- If we need to slow down and discuss, let me or the speaker know.
+ - A lot can be learned from a discussion.
+ - Most likely someone has the same question.
+ - We are all here to learn.
## Pace {-}
- We'll _try_ to cover 1 chapter/week, but...
- ...It's ok to split chapters when they feel like too much.
- We will try to meet every week, but will likely take some breaks for holidays, etc.
+- The session will be exactly one hour.
+- I encourage the group to adopt a 'go no matter what' mentality.
+
+## Group introductions {-}
+
+- If you feel comfortable sharing:
+ - Who are you?
+ - Where you calling in from? (If you're not comfortable sharing, skip)
+ - How long have you been using R?
+ - What was your introduction to R?
+ - What are you most looking forward to during the group?
+
+## `git` and `GitHub` {-}
+
+- If you are unfamilar with these tools, it's best to use the workflows made easy by the `usethis` package.
+ - [Managing Git(Hub) credentials](https://usethis.r-lib.org/articles/git-credentials.html).
+ - [Pull request helpers](https://usethis.r-lib.org/articles/pr-functions.html).
+ - [Check out the notes `README.md` file for exact steps](https://github.com/r4ds/bookclub-advr#readme).
+ - The community (especially `@jonthegeek`) and myself (`@Collin Berke`) are there to help.
+ - This is a great opportunity to become more comfortable with these tools.
+
+- If you're comforable with `git` and `GitHub`:
+ - Fork the repo.
+ - Create a branch with an informative name.
+ - Submit a pull request via the `R4DS` repo of the book.
+ - PR's are automatically tested and reviewed before being merged.
+
+## Resources to learn more about `git` and GitHub {-}
+
+- There are so many tools to use `git` and interface with `GitHub`.
+ - If you just want to stick with what is familiar, just use the `usethis` package.
+- [Happy Git and GitHub for the useR](https://happygitwithr.com/).
+- [`usethis`'s pull request helpers](https://usethis.r-lib.org/articles/pr-functions.html).
+- [`git`'s documentation](https://git-scm.com/doc).
+- [MShiny Cohort 2 Introduction](https://www.youtube.com/watch?v=beOYuHG9Xng&list=PL3x6DOfs2NGjhwrYvdmrKRNcvXX7X6ldt).
+- [Git for Book Clubs YouTube playlist](https://www.youtube.com/playlist?list=PL3x6DOfs2NGhS_PhklqT6PwK1Fh7blgP2).
