script comment updates

docker/make-requirements.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 set -euo pipefail
-# This script is used to generate requirements files for R and Python packages
+# This script is used to generate or update requirements/lock files for R and Python packages
 # Requires that the `pip-tools` python package is installed.
 # Before running, make sure that the renv.lock file and installed libaries are
 # consistent with renv::snapshot() or renv::restore()

docker/scripts/make-lockfile.R

@@ -1,9 +1,11 @@
 #!/usr/bin/env Rscript
 
-# This script is used to make a lockfile based on the current renv environment,
+# This script is used to create or update a lockfile based on the current renv environment,
 # including scpcaTools dependencies and any additional packages specified by the user.
 # This means that it does _not_ look at what files are used by scripts in the project, except
 # for the package DESCRIPTION file.
+# The main `renv.lock` file is not updated by this script, but must be up to date with the
+# current environment before running this script.
 
 library(optparse)