clean up and updates

Author: davidkane9

.gitignore

@@ -5,8 +5,8 @@
 
 r4ds.tutorials.Rproj
 
-# According to chatGPT, this .gitignore line will match any 
-# subdirectory under inst/tutorials/ except for data, images or those 
+# According to chatGPT, this .gitignore line will match any
+# subdirectory under inst/tutorials/ except for data, images or those
 # ending in .Rmd.
 
 inst/tutorials/[^/]*/(?!(data|images|.*Rmd))
@@ -17,7 +17,7 @@ inst/tutorials/*/*html
 
 inst/tutorials/*/*_files/
 
-# Not sure why this is needed, but something in the above was preventing git 
+# Not sure why this is needed, but something in the above was preventing git
 # from noticing these files, so I needed to explicitly include them. We
 # should go back and fix this properly.
 
@@ -33,3 +33,5 @@ inst/tutorials/*/tutorial_cache
 
 
 
+
+/.quarto/

DESCRIPTION

@@ -1,6 +1,6 @@
 Package: r4ds.tutorials
 Title: Tutorials for "R for Data Science"
-Version: 0.3.1.9000
+Version: 0.3.1.9001
 Authors@R: 
     person(given = "David",
            family = "Kane",

NEWS.md

@@ -1,5 +1,7 @@
 # r4ds.tutorials (development version)
 
+* Update Introduction tutorial.
+
 # r4ds.tutorials 0.3.1
 
 * Clean up tutorials. Remove junk files.

README.Rmd

@@ -31,7 +31,11 @@ The promise we make to instructors is that, if they assign our tutorial for Chap
 
 Our causal claim is that, if an instructor were to randomly assign half the class to do these tutorials and half to simply complete the reading, the half completing the tutorials would perform much better for the rest of the course.
 
-Note that most of the tutorials follow the associated chapters from [*R for Data Science (2e)*](https://r4ds.hadley.nz/). This is *not* true, however, for these tutorials: Introduction, RStudio and Code, RStudio and Github, Terminal, and Quarto. In those tutorials, we cover material which we feel belongs in any introductory data science course.
+## Extra material
+
+Note that most of the tutorials follow the associated chapters from [*R for Data Science (2e)*](https://r4ds.hadley.nz/). This is *not* true, however, for several other tutorials like Introduction, RStudio and Code, Quarto Websites Introduction, Terminal, et cetera. In those tutorials, we cover material which we feel belongs in any introductory data science course which uses RStudio.
+
+However, the future of data science belongs to [Positron](https://positron.posit.co/), so we recommend that teachers use Positron rather than RStudio. In that case, you should assign the tutorials from the **[positron.tutorials](https://ppbds.github.io/positron.tutorials/)** package in place of the similar tutorials in **r4ds.tutorials**. We no longer actively maintain these extra RStudio tutorials in this package. In the next version, we will delete them.
 
 ## Installation
 
@@ -51,7 +55,18 @@ If R offers you the option to update some packages, you should do so. For packag
 
 Then **restart your R session** or **restart RStudio**.
 
-## Accessing tutorials
+
+## Positron users
+
+Positron user should be aware of two things. First, tutorials in Positron must be run "by hand," using the `run_tutorial()` function from the **learnr** package. Example:
+
+````
+learnr::run_tutorial(name = "00-introduction", package = "r4ds.tutorials")
+````
+
+Second, many of the **r4ds.tutorials** were written specifically for RStudio. Fortunately, the **[positron.tutorials](https://ppbds.github.io/positron.tutorials/)** package includes versions of those tutorials written for Positron. 
+
+## RStudio users
 
 In order to access the tutorials, start by loading the package.
 
@@ -74,4 +89,4 @@ Because tutorials within the Tutorial pane are sorted in alphabetical order by t
 
 In order to expand the window, you can drag and enlarge the tutorial pane inside RStudio. In order to open a pop-up window, click the "Show in New Window" icon next to the home icon.
 
-You may notice that the Jobs tab in the lower left will create output as the tutorial is starting up. This is because RStudio is running the code to create the tutorial. If you accidentally clicked "Start Tutorial" and would like to stop the job from running, you can click the back arrow in the Jobs tab, and then press the red stop sign icon. Your work will be saved between RStudio sessions, meaning that you can complete a tutorial in multiple sittings. Once you have completed a tutorial, follow the instructions on the tutorial `Submit` page and, if you're a student, submit your answers as instructed.
+You may notice that the Jobs tab in the lower left will create output as the tutorial is starting up. This is because RStudio is running the code to create the tutorial. If you accidentally clicked "Start Tutorial" and would like to stop the job from running, you can click the back arrow in the Jobs tab, and then press the red stop sign icon. Your work will be saved between RStudio sessions, meaning that you can complete a tutorial in multiple sittings. Once you have completed a tutorial, follow the instructions on the tutorial `Submit` page and, if you're a student, submit your answers as instructed.