markdown source builds

actions-user · actions-user · commit f28c8e042416 · 2026-01-22T01:55:01.000Z
Auto-generated via `{sandpaper}` Source : a8beaa1 Branch : main Author : Tim Dennis <tdennis@library.ucla.edu> Time : 2026-01-22 01:54:07 +0000 Message : Merge pull request #34 from LibraryCarpentry/feat/inputs-outputs Add section on Defining Inputs and Outputs
diff --git a/computation_programming.md b/computation_programming.md
@@ -24,7 +24,23 @@ exercises: 10
 
 *Decomposition* is crucial in any kind of problem breakdown, but especially so in programming. The computer must be told **precisely** what to do, and in what order, so problems must be broken down into discrete parts and each section coded appropriately.
 
-Suppose we want to find the ten words most commonly used in a text. How might we go about that?
+#### Defining Inputs and Outputs
+
+Before we can tell the computer *what* to do (the algorithm), we must clarify *what data* we are working with. Every computational problem involves a transformation:
+
+1.  **Input:** What is the starting state? What data do we have? What format is it in?
+2.  **Output:** What is the desired goal? What should the result look like?
+
+If we don't define these clearly, we cannot design effective steps to bridge the gap.
+
+Suppose we want to find the ten words most commonly used in a text.
+
+**Input:** A digital text file (e.g., a book chapter).
+**Output:** A list of the top 10 most frequent words.
+
+The *process* (or algorithm) is the series of steps that turns that specific Input into that specific Output.
+
+How might we go about that?
 
 #### Linear code
 
diff --git a/config.yaml b/config.yaml
@@ -0,0 +1,88 @@
+#------------------------------------------------------------
+# Values for this lesson.
+#------------------------------------------------------------
+
+# Which carpentry is this (swc, dc, lc, or cp)?
+# swc: Software Carpentry
+# dc: Data Carpentry
+# lc: Library Carpentry
+# cp: Carpentries (to use for instructor training for instance)
+# incubator: The Carpentries Incubator
+carpentry: 'lc'
+
+# Overall title for pages.
+title: 'Introducing Computational Thinking'
+
+# Date the lesson was created (YYYY-MM-DD, this is empty by default)
+created: "2022-08-12"
+
+# Comma-separated list of keywords for the lesson
+keywords: 'software, data, lesson, The Carpentries'
+
+# Life cycle stage of the lesson
+# possible values: pre-alpha, alpha, beta, stable
+life_cycle: 'alpha'
+
+# License of the lesson materials (recommended CC-BY 4.0)
+license: 'CC-BY 4.0'
+
+# Link to the source repository for this lesson
+source: 'https://github.com/LibraryCarpentry/lc-computational-thinking/'
+
+# Default branch of your lesson
+branch: 'main'
+
+# Who to contact if there are any issues
+contact: 'team@carpentries.org'
+
+# Navigation ------------------------------------------------
+#
+# Use the following menu items to specify the order of
+# individual pages in each dropdown section. Leave blank to
+# include all pages in the folder.
+#
+# Example -------------
+#
+# episodes:
+# - introduction.md
+# - first-steps.md
+#
+# learners:
+# - setup.md
+#
+# instructors:
+# - instructor-notes.md
+#
+# profiles:
+# - one-learner.md
+# - another-learner.md
+
+# Order of episodes in your lesson
+episodes: 
+- intro.md
+- exercise.md
+- computation_practice.md
+- computation_programming.md
+- pseudocode.md
+
+
+# Information for Learners
+learners: 
+
+# Information for Instructors
+instructors: 
+
+# Learner Profiles
+profiles: 
+
+# Customisation ---------------------------------------------
+#
+# This space below is where custom yaml items (e.g. pinning
+# sandpaper and varnish versions) should live
+
+url: 'https://library-carpentry.org/lc-computational-thinking'
+analytics: carpentries
+lang: en
+
+
+
diff --git a/md5sum.txt b/md5sum.txt
@@ -2,18 +2,17 @@
 "AUTHORS.md" "543321041272a545f730a8fbec4d66fc" "site/built/AUTHORS.md" "2026-01-22"
 "CODE_OF_CONDUCT.md" "c93c83c630db2fe2462240bf72552548" "site/built/CODE_OF_CONDUCT.md" "2026-01-22"
 "LICENSE.md" "b24ebbb41b14ca25cf6b8216dda83e5f" "site/built/LICENSE.md" "2026-01-22"
-"config.yaml" "3e3ee236bb414febb63304d020f3fcea" "site/built/config.yaml" "2026-01-22"
+"config.yaml" "c7f18a7fa3ac579e78cfe81367bb2b9e" "site/built/config.yaml" "2026-01-22"
 "index.md" "bd2d349d4978ed3c68bb2b301a671bdc" "site/built/index.md" "2026-01-22"
 "search.md" "2d215d6e5c915ce30f5a5072d986609f" "site/built/search.md" "2026-01-22"
 "episodes/intro.md" "e176eef6a3acadfca8817bf38d46bb9f" "site/built/intro.md" "2026-01-22"
 "episodes/exercise.md" "a2aa30d792c70d1cf39f740a85e108c5" "site/built/exercise.md" "2026-01-22"
 "episodes/computation_practice.md" "ddb122e2e242e1587011dea9aba364fb" "site/built/computation_practice.md" "2026-01-22"
-"episodes/computation_programming.md" "7e69751fdb0fc9d7d74fb641ae898f0a" "site/built/computation_programming.md" "2026-01-22"
-"episodes/pseudocode.md" "0ea2e3e7d977ad7245d0df4868503439" "site/built/pseudocode.md" "2026-01-22"
-"episodes/solutions.Rmd" "3c9c1e7239d7d5f5fc849c1d53530b5a" "site/built/solutions.md" "2026-01-22"
+"episodes/computation_programming.md" "1ab7575ff080aa8e5cae77579eb08a88" "site/built/computation_programming.md" "2026-01-22"
+"episodes/pseudocode.md" "4d40f6d967401096851da13f3cca7eb7" "site/built/pseudocode.md" "2026-01-22"
 "instructors/instructor-notes.md" "3e3dd7c81b260ed9ea96b3f927a3dbe0" "site/built/instructor-notes.md" "2026-01-22"
 "learners/jargon_busting.md" "28f639571863b330f8d791d02b226821" "site/built/jargon_busting.md" "2026-01-22"
 "learners/reference.md" "406421cb0e6eef1d001ebe4c82f0b9e2" "site/built/reference.md" "2026-01-22"
 "learners/setup.md" "2ce211390c1f4929a8ce5bb0479031ca" "site/built/setup.md" "2026-01-22"
 "profiles/learner-profiles.md" "60b93493cf1da06dfd63255d73854461" "site/built/learner-profiles.md" "2026-01-22"
-"renv/profiles/lesson-requirements/renv.lock" "8f6f76231aa047218ce8f4759c854ffd" "site/built/renv.lock" "2026-01-22"
+"renv/profiles/lesson-requirements/renv.lock" "31cf7907c75c145ec5732da29620c713" "site/built/renv.lock" "2026-01-22"
diff --git a/pseudocode.md b/pseudocode.md
@@ -140,6 +140,12 @@ One way to do that is to check we have coded the workflow correctly *before* we
 
 Write some pseudocode for that step of the process.
 
+::: solution
+To prevent accidental deletion of files, we could introduce a step to check whether or not to delete a file, e.g., by using the remove command `rm` in the Unix shell with an `-i` flag. The `-i` flag forces the system to ask for confirmation on whether or not to delete a file. One can answer either **Y** or **N** to the example below.
+
+![Confirming a remove command](fig/code-in-shell.png){alt="RM command in the shell", width="75%"}
+:::
+
 ::::::::::::::
 
 ::: challenge
@@ -175,10 +181,6 @@ Again, a shell script could be used to automate this work. Given that these task
 
 -------------------
 
-Some potential solutions to these practice coding exercises can be found on the [Solutions](/solutions.html) page.
-
----------------------------------
-
 #### Learning to program
 
 This lesson should help you prepare to learn to code by understanding the process that coders use to break complex problems down into programmable parts. 
diff --git a/renv.lock b/renv.lock
@@ -0,0 +1,76 @@
+{
+  "R": {
+    "Version": "4.5.2",
+    "Repositories": [
+      {
+        "Name": "carpentries",
+        "URL": "https://carpentries.r-universe.dev"
+      },
+      {
+        "Name": "carpentries_archive",
+        "URL": "https://carpentries.github.io/drat"
+      },
+      {
+        "Name": "CRAN",
+        "URL": "https://cran.rstudio.com"
+      }
+    ]
+  },
+  "Packages": {
+    "renv": {
+      "Package": "renv",
+      "Version": "1.1.6",
+      "Source": "Repository",
+      "Type": "Package",
+      "Title": "Project Environments",
+      "Authors@R": "c( person(\"Kevin\", \"Ushey\", role = c(\"aut\", \"cre\"), email = \"kevin@rstudio.com\", comment = c(ORCID = \"0000-0003-2880-7407\")), person(\"Hadley\", \"Wickham\", role = c(\"aut\"), email = \"hadley@rstudio.com\", comment = c(ORCID = \"0000-0003-4757-117X\")), person(\"Posit Software, PBC\", role = c(\"cph\", \"fnd\")) )",
+      "Description": "A dependency management toolkit for R. Using 'renv', you can create and manage project-local R libraries, save the state of these libraries to a 'lockfile', and later restore your library as required. Together, these tools can help make your projects more isolated, portable, and reproducible.",
+      "License": "MIT + file LICENSE",
+      "URL": "https://rstudio.github.io/renv/, https://github.com/rstudio/renv",
+      "BugReports": "https://github.com/rstudio/renv/issues",
+      "Imports": [
+        "utils"
+      ],
+      "Suggests": [
+        "BiocManager",
+        "cli",
+        "compiler",
+        "covr",
+        "cpp11",
+        "curl",
+        "devtools",
+        "generics",
+        "gitcreds",
+        "jsonlite",
+        "jsonvalidate",
+        "knitr",
+        "miniUI",
+        "modules",
+        "packrat",
+        "pak",
+        "R6",
+        "remotes",
+        "reticulate",
+        "rmarkdown",
+        "rstudioapi",
+        "shiny",
+        "testthat",
+        "uuid",
+        "waldo",
+        "yaml",
+        "webfakes"
+      ],
+      "Encoding": "UTF-8",
+      "RoxygenNote": "7.3.3",
+      "VignetteBuilder": "knitr",
+      "Config/Needs/website": "tidyverse/tidytemplate",
+      "Config/testthat/edition": "3",
+      "Config/testthat/parallel": "true",
+      "Config/testthat/start-first": "bioconductor,python,install,restore,snapshot,retrieve,remotes",
+      "NeedsCompilation": "no",
+      "Author": "Kevin Ushey [aut, cre] (ORCID: <https://orcid.org/0000-0003-2880-7407>), Hadley Wickham [aut] (ORCID: <https://orcid.org/0000-0003-4757-117X>), Posit Software, PBC [cph, fnd]",
+      "Maintainer": "Kevin Ushey <kevin@rstudio.com>",
+      "Repository": "CRAN"
+    }
+  }
+}
diff --git a/solutions.md b/solutions.md
