Tweak output manually on non-episode files

Author: Bisaloo

instructors/instructor-notes.md

@@ -40,18 +40,13 @@ As an instructor, we encourage you to do the live coding directly in this file,
 
 ## R Version
 
-With the release of R 4.
-0\.
-0 in early 2020, an important change has been made to R: The default for `stringsAsFactors` is now `FALSE` instead of `TRUE`.
+With the release of R 4.0.0 in early 2020, an important change has been made to R: The default for `stringsAsFactors` is now `FALSE` instead of `TRUE`.
 As a result, the `read.csv()` and `data.frame()` functions do not automatically convert character columns to factors anymore (you can read more about it [in this post on the R developer blog](https://developer.r-project.org/Blog/public/2020/02/16/stringsasfactors/index.html)).
 
-This change should not cause any problems with this lesson, independent of whether R >4.
-0 is used or not, because it uses `read_csv()` from the **`tidyverse`** package throughout.
+This change should not cause any problems with this lesson, independent of whether R >4.0 is used or not, because it uses `read_csv()` from the **`tidyverse`** package throughout.
 Other than `read.csv()` from base R, `read_csv()` never converts character columns to factors, regardless of the R version.
 
-Nevertheless, it is recommended that learners install a version of R ≥4.
-0\.
-0, and instructors and helpers should be aware of this potential source of error.
+Nevertheless, it is recommended that learners install a version of R ≥4.0.0, and instructors and helpers should be aware of this potential source of error.
 
 ## RStudio and Multiple R Installs
 
@@ -67,13 +62,9 @@ First, check for the appropriate R installation in the library;
 ls -l /Library/Frameworks/R.framework/Versions/
 ```
 
-We are currently using R 4.
-0\.
-x.
+We are currently using R 4.0.x.
 If it isn't there, they will need to install it.
-If it is present, you will need to set the symbolic link to Current to point to the 4.
-0\.
-x directory:
+If it is present, you will need to set the symbolic link to Current to point to the 4.0.x directory:
 
 ```
 ln -s /Library/Frameworks/R.framework/Versions/3.6.x /Library/Frameworks/R.framework/Version/Current
@@ -109,94 +100,71 @@ install.packages(c("readr", "lubridate", "dplyr", "tidyr", "ggplot2", "dbplyr"))
 ### Before we start
 
 - The main goal here is to help the learners be comfortable with the RStudio
-  interface. We use RStudio because it helps make using R more organized and
+  interface.
+  We use RStudio because it helps make using R more organized and
   user friendly.
-- The "Why learning R?" section contains suggestions of what you could tell your
-  learners about the benefits of learning R. However, it's best if you can talk
-  here about what has worked for you personally.
-- Go very slowly in the "Getting setup section". Make sure everyone is following
-  along (remind learners to use the stickies). Plan with the helpers at this
-  point to go around the room, and be available to help. It's important to make
-  sure that learners are in the correct working directory, and that they create
-  a `data_raw`  (all lowercase) subfolder.
+- The "Why learning R?" section contains suggestions of what you could tell your learners about the benefits of learning R.
+  However, it's best if you can talk here about what has worked for you personally.
+- Go very slowly in the "Getting setup section". Make sure everyone is following along (remind learners to use the stickies).
+  Plan with the helpers at this point to go around the room, and be available to help.
+  It's important to make sure that learners are in the correct working directory, and that they create a `data_raw`  (all lowercase) subfolder.
 - The seeking help section is relatively long, and while it's useful to
-  demonstrate a couple of ways to get help from within R, you may want to mostly
-  point the workshop participants to this useful reference so that they can
-  refer to it after the workshop.
-- In the "where to ask for help section?", you may want to emphasize the first
-  point about how workshops are a great way to create community of learners that
-  can help each others during and after the workshop.
+  demonstrate a couple of ways to get help from within R, you may want to mostly point the workshop participants to this useful reference so that they can refer to it after the workshop.
+- In the "where to ask for help section?", you may want to emphasize the first point about how workshops are a great way to create community of learners that can help each others during and after the workshop.
 
 ### Intro to R
 
-- When going over the section on assignments, make
-  sure to pause for at least 30 seconds when asking "What do you think is the
-  current content of the object weight\_lb? 126.5 or 220?". For learners with no
-  programming experience, this is a new and important concept.
+- When going over the section on assignments, make sure to pause for at least 30 seconds when asking "What do you think is the
+  current content of the object weight\_lb? 126.5 or 220?".
+  For learners with no programming experience, this is a new and important concept.
 - Given that the concept of missing data is an important feature of the R
   language, it is worth spending enough time on it.
 
 ### Starting with data
 
 The two main goals for this lessons are:
 
-- To make sure that learners are comfortable with working with data frames, and
-  can use the bracket notation to select slices/columns
+- To make sure that learners are comfortable with working with data frames, and can use the bracket notation to select slices/columns
 - To expose learners to factors. Their behavior is not necessarily intuitive,
-  and so it is important that they are guided through it the first time they are
-  exposed to it. The content of the lesson should be enough for learners to
-  avoid common mistakes with them.
-- If the learners are not familiar with the ecology terminology used in the data
-  set, it might be a good idea to briefly review it here. Especially the terms
-  *genus* and *plot* have caused some confusion to learners in the past.
-  It might help to point out that the plural of genus is *genera*, and that
-  `plot_id` and `plot_type` in the data set refer to the ID and type of a plot
-  of land that was surveyed by the researchers in the study.
+  and so it is important that they are guided through it the first time they are exposed to it.
+  The content of the lesson should be enough for learners to avoid common mistakes with them.
+- If the learners are not familiar with the ecology terminology used in the data set, it might be a good idea to briefly review it here.
+  Especially the terms *genus* and *plot* have caused some confusion to learners in the past.
+  It might help to point out that the plural of genus is *genera*, and that `plot_id` and `plot_type` in the data set refer to the ID and type of a plot of land that was surveyed by the researchers in the study.
 
 ### Manipulating data
 
 - For this lesson make sure that learners are comfortable using pipes.
-- There is also sometimes some confusion on what the arguments of `group_by`
-  should be.
+- There is also sometimes some confusion on what the arguments of `group_by` should be.
 - This lesson uses the tidyr package to reshape data for plotting
-- After this lesson students should be familiar with the spread() and gather()
-  functions available in tidyr
-- While working with the example for mutate(), it is difficult to see the
-  "weight" columns on a zoomed in RStudio screen. Including a select()
-  command to select the columns "weight\_kg" and "weight\_lb" makes it easier
-  to view how the "weight" columns are changed.
+- After this lesson students should be familiar with the spread() and gather() functions available in tidyr
+- While working with the example for mutate(), it is difficult to see the "weight" columns on a zoomed in RStudio screen.
+  Including a select() command to select the columns "weight\_kg" and "weight\_lb" makes it easier to view how the "weight" columns are changed.
 - It is crucial that learners use the function `read_csv()` from tidyverse,
-  not `read.csv()` from base R. Using the wrong function will cause unexpected
-  results further down the line, especially in the section on working with
-  factors.
+  not `read.csv()` from base R.
+  Using the wrong function will cause unexpected results further down the line, especially in the section on working with factors.
 - Note: If students end up with 30521 rows for `surveys_complete` instead of
-  the expected 30463 rows at the end of the chapter, then they have likely used
-  `read.csv()` and not `read_csv()` to import the data.
+  the expected 30463 rows at the end of the chapter, then they have likely used `read.csv()` and not `read_csv()` to import the data.
 - When explaining `view()`, consider mentioning that is a function of the
-  **`tibble`** package, and that the base function `View()` can also be used to
-  view a data frame.
+  **`tibble`** package, and that the base function `View()` can also be used to view a data frame.
 
 ### Visualizing data
 
-- This lesson is a broad overview of ggplot2 and focuses on (1) getting familiar
-  with the layering system of ggplot2, (2) using the argument `group` in the
-  `aes()` function, (3) basic customization of the plots.
-- It maybe worthwhile to mention that we can also specify colors by color HEX code ( [http://colorbrewer2.org](https://colorbrewer2.org))
+- This lesson is a broad overview of ggplot2 and focuses on (1) getting familiar with the layering system of ggplot2, (2) using the argument `group` in the `aes()` function, (3) basic customization of the plots.
+- It maybe worthwhile to mention that we can also specify colors by color HEX code (<http://colorbrewer2.org>)
   ```
   ggplot(data = surveys_complete, mapping = aes(x = weight, y = hindfoot_length)) +
       geom_point(alpha = 0.1, color = "#FF0000")
   ```
 
 ### R and SQL
 
-- Ideally this lesson is best taught at the end of the workshop (as a capstone
-  example) to illustrate how the tools covered can integrate with each
-  others. Depending on the audience, and the pace of the workshop, it can be
+- Ideally this lesson is best taught at the end of the workshop (as a capstone example) to illustrate how the tools covered can integrate with each
+  others.
+  Depending on the audience, and the pace of the workshop, it can be
   shown as a demonstration rather than a typically lesson.
-- The explanation of how dplyr's verb syntax is translated into SQL statements,
-  and the section on laziness are optional and don't need to be taught in detail
-  during a workshop. They can be useful after a workshop for learners interested
-  in learning more about the topics or for instructors to answer questions from
+- The explanation of how dplyr's verb syntax is translated into SQL statements, and the section on laziness are optional and don't need to be taught in detail during a workshop.
+  They can be useful after a workshop for learners interested in learning more about the topics or for instructors to answer questions from
   the workshop participants.
 
 ## Potential issues \& solutions

learners/reference.md

@@ -100,5 +100,3 @@ Cheat sheet of functions used in the lessons
 - `inner_join()`  # perform an inner join between two tables
 - `src_sqlite()` # connect dplyr to a SQLite database file
 - `copy_to()`     # copy a data frame as a table into a database
-
-

learners/setup.md

@@ -65,13 +65,19 @@ You have to install R before you install RStudio.
 
 If you already have R and RStudio installed, first check if your R version is up to date:
 
-- When you open RStudio your R version will be printed in the console on the bottom left. Alternatively, you can type `sessionInfo()` into the console. If your R version is 4.0.0 or later, you don't need to update R for this lesson. If your version of R is older than that, download and install the latest version of R from the R project website [for Windows](https://cran.r-project.org/bin/windows/base/), [for MacOS](https://cran.r-project.org/bin/macosx/), or [for Linux](https://cran.r-project.org/bin/linux/)
+- When you open RStudio your R version will be printed in the console on the bottom left.
+  Alternatively, you can type `sessionInfo()` into the console.
+  If your R version is 4.0.0 or later, you don't need to update R for this lesson.
+  If your version of R is older than that, download and install the latest version of R from the R project website [for Windows](https://cran.r-project.org/bin/windows/base/), [for MacOS](https://cran.r-project.org/bin/macosx/), or [for Linux](https://cran.r-project.org/bin/linux/)
 - It is not necessary to remove old versions of R from your system, but if you wish to do so you can check [How do I uninstall R?](https://cran.r-project.org/bin/windows/base/rw-FAQ.html#How-do-I-UNinstall-R_003f)
-- After installing a new version of R, you will have to reinstall all your packages with the new version. For Windows, there is a package called `installr` that can help you with upgrading your R version and migrate your package library. A similar package called `pacman` can help with updating R packages across
+- After installing a new version of R, you will have to reinstall all your packages with the new version.
+  For Windows, there is a package called `installr` that can help you with upgrading your R version and migrate your package library.
+  A similar package called `pacman` can help with updating R packages across
   To update RStudio to the latest version, open RStudio and click on
-  `Help > Check for Updates`. If a new version is available follow the
-  instruction on screen. By default, RStudio will also automatically notify you
-  of new versions every once in a while.
+  `Help > Check for Updates`.
+  If a new version is available follow the
+  instruction on screen.
+  By default, RStudio will also automatically notify you of new versions every once in a while.
 
 ::::::::::::::::::::::::::::: callout
 
@@ -130,4 +136,3 @@ The data files for the lesson can be downloaded manually:
 
 - [cleaned data](../episodes/data/cleaned/surveys_complete_77_89.csv) and
 - [zip file of raw data](../episodes/data/new_data.zip).
-