Merge pull request #321 from coding-for-reproducible-research/amy_renv

Marge branch 'amy_renv' into 'main'

Author: liamjberrisford

short_courses/r_environments.ipynb

@@ -449,7 +449,7 @@
     "\n",
     "**Solutions:**\n",
     "\n",
-    "* If exact reproducibility isn't critical, update to a more recent R version and/or newer package versions.\n",
+    "* If exact reproducibility is not required, consider updating to a more recent R version and/or newer package versions.\n",
     "* For legacy work, search for archived source tarballs or consult the CRAN archive, but success isn't guaranteed.\n",
     "\n",
     "#### Backdating\n",
@@ -473,7 +473,7 @@
     "    dplyr (>= 1.0.0)\n",
     "```\n",
     "\n",
-    "To install a particular version using `renv` (which is then captured in `renv.lock` by calling `renv::snapshot()`):\n",
+    "To install a particular version using `renv` (which will be recorded in `renv.lock` after you call `renv::snapshot()`):\n",
     "\n",
     "```\n",
     "renv::install(\"[email protected]\")\n",
@@ -486,11 +486,10 @@
     "**Symptoms:**\n",
     "\n",
     "* Package installation fails with errors about missing libraries (e.g., \"cannot find -lssl\", \"libcurl not found\", missing `.so` files).\n",
-    "* Consult the CRAN page for each package (OR SPECIFIED ONE IN ERROR?); most list system requirements. As an example, the openssl and curl packages commonly require system libraries. See this GitHub issue for a real-world case and solution.\n",
     "\n",
     "**Solutions:**\n",
     "\n",
-    "* Check the CRAN page for each package for system requirements. The `openssl` and `curl` packages are a common source of these issues.\n",
+    "* Check the CRAN page for each package for any system requirements (listed beside `SystemRequirements`). The [`openssl`](https://cran.r-project.org/web/packages/openssl/index.html) and [`curl`](https://cran.r-project.org/web/packages/curl/index.html) packages are a common source of these issues.\n",
     "* Install the required system dependencies and document them in your `README` for others. For example:\n",
     "  * Ubuntu/Debian: `sudo apt-get install libssl-dev libcurl4-openssl-dev`.\n",
     "  * Fedora/RHEL: `sudo dnf install openssl-devel libcurl-devel`.\n",
@@ -499,7 +498,7 @@
     "\n",
     "#### Legacy user libraries\n",
     "\n",
-    "On systems where R has been installed for a long time, the user library (the default location for installed packages) may contain outdated or conflicting packages. This can interfere with `renv`, sometimes causing it to fail silently or behave unpredictably.\n",
+    "If R has been installed for a long time, your user library (the default location for installed packages) may contain outdated or conflicting packages. This can interfere with `renv`, sometimes causing silent failures or unpredictable behaviour.\n",
     "\n",
     "**Symptoms:**\n",
     "\n",