Edit Introduction Chapter (#114)

* Edit Chapter 01 per feedback * Remove reference to RStudio * Update Introduction Chapter * Small edit * Small edit * Small edits * SZ intro review pt 1 * Table of packages in intro * Remove loading of remotes * Remove repeat bib entry, clean renv * remove intermediate files * Shorten sha in table * Add chapter titles, intro feedback * Apply suggestions from code review --------- Co-authored-by: Stephanie Zimmer <[email protected]> Co-authored-by: Rebecca Powell <[email protected]>
tidy-survey-r · Mar 31, 2024 · 8e0880b · 8e0880b
1 parent 449f197
commit 8e0880b
Show file tree

Hide file tree

Showing 6 changed files with 186 additions and 90 deletions.
diff --git a/01-introduction.Rmd b/01-introduction.Rmd
diff --git a/08-communicating-results.Rmd b/08-communicating-results.Rmd
@@ -121,7 +121,7 @@ trust_gov <- anes_des %>%
 trust_gov
 ```
 
-The default output generated by R may work for initial viewing inside RStudio or when creating basic output in an R Markdown or Quarto document. However, when presenting these results in other publications, such as the print version of this book or with other formal dissemination modes, modifying the display can improve our reader's experience. 
+The default output generated by R may work for initial viewing inside our IDE or when creating basic output in an R Markdown or Quarto document. However, when presenting these results in other publications, such as the print version of this book or with other formal dissemination modes, modifying the display can improve our reader's experience. 
 
 Looking at the output from `trust_gov`, a couple of improvements are obvious: (1) switching to percentages instead of proportions and (2) using the variable names as column headers. The {gt} package is a good tool for implementing better labeling and creating publishable tables. Let's walk through some code as we make a few changes to improve the table's usefulness. 
 

diff --git a/13-ncvs-vignette.Rmd b/13-ncvs-vignette.Rmd
@@ -602,7 +602,7 @@ pers_des <- pers_vsum_slim %>%
 
 ## Calculating Estimates
 
-Now that we have prepared our data and created the design effects, we can calculate our estimates. As a reminder, those are:
+Now that we have prepared our data and created the design objects, we can calculate our estimates. As a reminder, those are:
 
 1. *Victimization totals* estimate the number of criminal victimizations with a given characteristic.
 

diff --git a/book.bib b/book.bib
@@ -144,6 +144,14 @@ @article{gelman2007weights
 	howpublished = {\url{https://doi.org/10.1214/088342306000000691}},
 	keywords     = {multilevel modeling, poststratification, sampling weights, shrinkage}
 }
+@article{gard2023weightsdef,
+	title        = {Why weight? Analytic approaches for large-scale population neuroscience data},
+	author       = {Gard, Arianna M. and Hyde, Luke W. and Heeringa, Steven G. and West, Brady T. and Mitchell, Colter},
+	year         = 2023,
+	journal      = {Dev Cogn Neurosci},
+	doi          = {10.1016/j.dcn.2023.101196},
+	howpublished = {\url{https://www.ncbi.nlm.nih.gov/pmc/articles/PMC9843279/}}
+}
 @article{bollen2016weightsreg,
 	title        = {Are Survey Weights Needed? A Review of Diagnostic Tests in Regression Analysis},
 	author       = {Bollen, Kenneth A. and Biemer, Paul P. and Karr, Alan F. and Tueller, Stephen and Berzofsky, Marcus E.},
@@ -245,6 +253,14 @@ @book{wickham2019advanced
 	publisher    = {CRC press},
 	howpublished = {\url{https://adv-r.hadley.nz/}}
 }
+@book{wickham2023r4ds,
+	title        = {R for Data Science},
+	author       = {Wickham, Hadley and Çetinkaya-Rundel, Mine and Grolemund, Garrett},
+	year         = 2023,
+	publisher    = {O'Reilly},
+	edition      = {2nd Edition},
+	howpublished = {\url{https://r4ds.hadley.nz/}}
+}
 @book{wickham2023ggplot2,
 	title        = {ggplot2: Elegant Graphics for Data Analysis},
 	author       = {Wickham, Hadley},
@@ -253,14 +269,6 @@ @book{wickham2023ggplot2
 	publisher    = {Springer},
 	howpublished = {\url{https://ggplot2-book.org/}}
 }
-@book{wickham2023r4ds,
-	title        = {R for Data Science: Import, Tidy, Transform, Visualize, and Model Data},
-	author       = {Wickham, Hadley and Çetinkaya-Rundel, Mine and Grolemund, Garrett},
-	edition      = {2rd Edition},
-	year         = 2023,
-	publisher    = {O'Reilly Media},
-	howpublished = {\url{https://r4ds.hadley.nz/}}
-}
 @misc{acs-pums-2021,
 	title        = {{Understanding and Using the American Community Survey Public Use Microdata Sample Files What Data Users Need to Know}},
 	author       = {{U.S. Census Bureau}},

diff --git a/index.Rmd b/index.Rmd
@@ -33,7 +33,7 @@ if (knitr:::is_html_output()){
 } else{
   options(width=72)
 }
-library(formatR)
+
 library(prettyunits)
 
 book_colors <- c("#0b3954", "#087e8b", "#bfd7ea", "#ff8484", "#8d6b94")

diff --git a/renv.lock b/renv.lock
@@ -696,16 +696,6 @@
       ],
       "Hash": "1a0a9a3d5083d0d573c4214576f1e690"
     },
-    "formatR": {
-      "Package": "formatR",
-      "Version": "1.14",
-      "Source": "Repository",
-      "Repository": "CRAN",
-      "Requirements": [
-        "R"
-      ],
-      "Hash": "63cb26d12517c7863f5abb006c5e0f25"
-    },
     "fs": {
       "Package": "fs",
       "Version": "1.6.2",
@@ -1883,6 +1873,19 @@
       ],
       "Hash": "3838071b66e0c566d55cc26bd6e27bf4"
     },
+    "sessioninfo": {
+      "Package": "sessioninfo",
+      "Version": "1.2.2",
+      "Source": "Repository",
+      "Repository": "CRAN",
+      "Requirements": [
+        "R",
+        "cli",
+        "tools",
+        "utils"
+      ],
+      "Hash": "3f9796a8d0a0e8c6eb49a4b029359d1f"
+    },
     "sf": {
       "Package": "sf",
       "Version": "1.0-14",