Deploying to gh-pages from @ b4be66e 🚀

OuhscBbmc · Oct 22, 2023 · f3957fe · f3957fe
1 parent 923f638
commit f3957fe
Show file tree

Hide file tree

Showing 39 changed files with 95 additions and 71 deletions.
diff --git a/ch-snippets.Rmd b/ch-snippets.Rmd
@@ -34,6 +34,14 @@ testit::assert(
   "The order of column names must match the expected list.",
   names(col_types) == colnames(ds)
 )
+
+# Alternatively, this provides more detailed error messages than `testit::assert()`
+# testthat::expect_equal(
+#   colnames(d),
+#   names(col_types),
+#   label = "worksheet's column name (x)",
+#   expected.label = "col_types' name (y)"
+# )
 ```
 
 ### Removing Trailing Comma from Header {#snippets-reading-trailing-comma}

diff --git a/depends.Rds b/depends.Rds
diff --git a/docs/404.html b/docs/404.html
@@ -7,7 +7,7 @@
 <title>Page not found | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="The page you requested cannot be found (perhaps it was moved or renamed). You may want to try searching to find the page's new location, or use the table of contents to find the page you are...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="Page not found | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="The page you requested cannot be found (perhaps it was moved or renamed). You may want to try searching to find the page's new location, or use the table of contents to find the page you are...">
@@ -125,7 +125,7 @@ <h1>Page not found<a class="anchor" aria-label="anchor" href="#page-not-found"><
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/acknowledgements.html b/docs/acknowledgements.html
@@ -7,7 +7,7 @@
 <title>H Acknowledgements | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="The authors thank all our colleagues for the discussions and experiences about data science that lead to this book. At OUHSC, this includes @adrose, @aggie-dbc, @ARPeters, @Ashley-Jorgensen,...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="H Acknowledgements | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="The authors thank all our colleagues for the discussions and experiences about data science that lead to this book. At OUHSC, this includes @adrose, @aggie-dbc, @ARPeters, @Ashley-Jorgensen,...">
@@ -167,7 +167,7 @@ <h1>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/architecture.html b/docs/architecture.html
@@ -7,7 +7,7 @@
 <title>Chapter 3 Architecture Principles | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="3.1 Encapsulation   3.2 Leverage team member’s strengths &amp; avoid weaknesses  3.2.1 Focused code files   3.2.2 Metadata for content experts   3.3 Scales  3.3.1 Single source &amp; single analysis  ...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="Chapter 3 Architecture Principles | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="3.1 Encapsulation   3.2 Leverage team member’s strengths &amp; avoid weaknesses  3.2.1 Focused code files   3.2.2 Metadata for content experts   3.3 Scales  3.3.1 Single source &amp; single analysis  ...">
@@ -211,7 +211,7 @@ <h3>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/automation.html b/docs/automation.html
@@ -7,7 +7,7 @@
 <title>Chapter 10 Automation &amp; Reproducibility | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="Automation is an important prerequisite of reproducibility.  10.1 Mediator A nontrivial project usually has multiple stages in its pipeline. Instead of a human deciding when to execute which...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="Chapter 10 Automation &amp; Reproducibility | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="Automation is an important prerequisite of reproducibility.  10.1 Mediator A nontrivial project usually has multiple stages in its pipeline. Instead of a human deciding when to execute which...">
@@ -290,7 +290,7 @@ <h3>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/ch-snippets.md b/docs/ch-snippets.md
@@ -34,6 +34,14 @@ testit::assert(
   "The order of column names must match the expected list.",
   names(col_types) == colnames(ds)
 )
+
+# Alternatively, this provides more detailed error messages than `testit::assert()`
+# testthat::expect_equal(
+#   colnames(d),
+#   names(col_types),
+#   label = "worksheet's column name (x)",
+#   expected.label = "col_types' name (y)"
+# )
 ```
 
 ### Removing Trailing Comma from Header {#snippets-reading-trailing-comma}

diff --git a/docs/coding.html b/docs/coding.html
@@ -7,7 +7,7 @@
 <title>Chapter 2 Coding Principles | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="2.1 Simplify  2.1.1 Data Types Use the simplest data type reasonable. A simpler data type is less likely contain unintended values. As we have seen, a string variable called gender can...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="Chapter 2 Coding Principles | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="2.1 Simplify  2.1.1 Data Types Use the simplest data type reasonable. A simpler data type is less likely contain unintended values. As we have seen, a string variable called gender can...">
@@ -469,7 +469,7 @@ <h3>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/collaboration.html b/docs/collaboration.html
@@ -7,7 +7,7 @@
 <title>Chapter 12 Parallel Collaboration | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="12.1 Social Contract Issues Organized Commits &amp; Coherent Diffs Branch &amp; Merge Strategy  12.2 Code Reviews Daily Reviews of PRs Periodic Reviews of Files  12.3 Remote Headset &amp; sharing screens ...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="Chapter 12 Parallel Collaboration | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="12.1 Social Contract Issues Organized Commits &amp; Coherent Diffs Branch &amp; Merge Strategy  12.2 Code Reviews Daily Reviews of PRs Periodic Reviews of Files  12.3 Remote Headset &amp; sharing screens ...">
@@ -219,7 +219,7 @@ <h3>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/document.html b/docs/document.html
@@ -7,7 +7,7 @@
 <title>Chapter 13 Documentation | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="13.1 Team-wide   13.2 Project-specific   13.3 Dataset Origin &amp; Structure   13.4 Issues &amp; Tasks  13.4.1 GitHub Issue Template If you are going to open up a repo/package to the public, consider...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="Chapter 13 Documentation | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="13.1 Team-wide   13.2 Project-specific   13.3 Dataset Origin &amp; Structure   13.4 Issues &amp; Tasks  13.4.1 GitHub Issue Template If you are going to open up a repo/package to the public, consider...">
@@ -207,7 +207,7 @@ <h2>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/example-chapter.html b/docs/example-chapter.html
@@ -7,7 +7,7 @@
 <title>G Example Chapter | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="This intro was copied from the 1st chapter of the example bookdown repo. I’m keeping it temporarily for reference. You can label chapter and section titles using {#label} after them, e.g., we can...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="G Example Chapter | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="This intro was copied from the 1st chapter of the example bookdown repo. I’m keeping it temporarily for reference. You can label chapter and section titles using {#label} after them, e.g., we can...">
@@ -306,7 +306,7 @@ <h1>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/example-dashboard.html b/docs/example-dashboard.html
@@ -7,7 +7,7 @@
 <title>F Example Dashboard | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="Communicating quantitative trends to a community with a quantitative phobia can be difficult. This appendix showcases a dashboard style that has evolved during the past few years of OSDH Home...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="F Example Dashboard | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="Communicating quantitative trends to a community with a quantitative phobia can be difficult. This appendix showcases a dashboard style that has evolved during the past few years of OSDH Home...">
@@ -353,7 +353,7 @@ <h3>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/git.html b/docs/git.html
@@ -7,7 +7,7 @@
 <title>A Git &amp; GitHub | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="A.1 Justification (Written in 2017 to justify the service to a corporation’s IT department.) Git and GitHub are the de facto version control software and hosting solution for software development...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="A Git &amp; GitHub | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="A.1 Justification (Written in 2017 to justify the service to a corporation’s IT department.) Git and GitHub are the de facto version control software and hosting solution for software development...">
@@ -320,7 +320,7 @@ <h2>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/index.html b/docs/index.html
@@ -7,7 +7,7 @@
 <title>Chapter 1 Introduction | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="Collection of publicly available practices of data science and analysis.">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="Chapter 1 Introduction | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="Collection of publicly available practices of data science and analysis.">
@@ -135,7 +135,7 @@ <h1>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/index.md b/docs/index.md
@@ -1,7 +1,7 @@
 ---
 title: "Collaborative Data Science Practices"
 author: "Will Beasley"
-date: "2023-10-03"
+date: "2023-10-22"
 site: bookdown::bookdown_site
 documentclass: book
 bibliography: [book.bib, packages.bib]

diff --git a/docs/patterns.html b/docs/patterns.html
@@ -7,7 +7,7 @@
 <title>Chapter 8 Patterns | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="8.1 Ellis  8.1.1 Purpose To incorporate outside data source into your system safely.  8.1.2 Philosophy  Without data immigration, all warehouses are useless. Embrace the power of fresh information...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="Chapter 8 Patterns | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="8.1 Ellis  8.1.1 Purpose To incorporate outside data source into your system safely.  8.1.2 Philosophy  Without data immigration, all warehouses are useless. Embrace the power of fresh information...">
@@ -493,7 +493,7 @@ <h3>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/presentations.html b/docs/presentations.html
@@ -7,7 +7,7 @@
 <title>D Presentations | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="Here is a collection of presentations by the BBMC and friends that may help demonstrate concepts discussed in the previous chapters.  D.1 CRDW  prairie-outpost-public: Documentation and starter...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="D Presentations | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="Here is a collection of presentations by the BBMC and friends that may help demonstrate concepts discussed in the previous chapters.  D.1 CRDW  prairie-outpost-public: Documentation and starter...">
@@ -266,7 +266,7 @@ <h2>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">

diff --git a/docs/prototype-r.html b/docs/prototype-r.html
@@ -7,7 +7,7 @@
 <title>Chapter 4 Prototypical R File | Collaborative Data Science Practices</title>
 <meta name="author" content="Will Beasley">
 <meta name="description" content="As stated in Consistency across Files, using a consistent file structure can (a) improve the quality of the code because the structure has been proven over time to facilitate good practices and...">
-<meta name="generator" content="bookdown 0.35 with bs4_book()">
+<meta name="generator" content="bookdown 0.36 with bs4_book()">
 <meta property="og:title" content="Chapter 4 Prototypical R File | Collaborative Data Science Practices">
 <meta property="og:type" content="book">
 <meta property="og:description" content="As stated in Consistency across Files, using a consistent file structure can (a) improve the quality of the code because the structure has been proven over time to facilitate good practices and...">
@@ -333,7 +333,7 @@ <h2>
 <footer class="bg-primary text-light mt-5"><div class="container"><div class="row">
 
   <div class="col-12 col-md-6 mt-3">
-    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-03.</p>
+    <p>"<strong>Collaborative Data Science Practices</strong>" was written by Will Beasley. It was last built on 2023-10-22.</p>
   </div>
 
   <div class="col-12 col-md-6 mt-3">