Merge branch 'review-documentation-2' into 'main'

Review documentation 2

See merge request mpsd-cs/mpsd-software!66

mpsd-software.py

@@ -551,13 +551,11 @@ def run(*args, counter=[0], **kwargs):
 def record_script_execution_summary(
     mpsd_release: str, root_dir: str, msg: str = None, **kwargs
 ) -> None:
-    """
-    Log the command used to build the toolchains.
+    """Log the command used to build the package_set.
 
-    It also logs information about the software environment installer branch,
-    the Spack environments branch, and the commit hashes of each.
-    It also logs steps taken
-    in the install process using the optional message argument.
+    It also logs information about the mpsd-software repository branch, the
+    spack-environments branch, and the commit hashes of each. It also logs
+    steps taken in the install process using the optional message argument.
 
     Parameters
     ----------
@@ -1098,9 +1096,9 @@ def main():
     list_of_cmds = [
         ("available", "What is available for installation?"),
         ("install", "Install a software environment"),
-        # ("reinstall", "Reinstall a software environment"),
-        # ("remove", "Remove a software environment or toolchains from an environment"),
-        # ("start-new", "Start a new software environment version"),
+        # ("reinstall", "Reinstall a package_set"),
+        # ("remove", "Remove a package set"),
+        # ("start-new", "Start a new MPSD software release version"),
         ("status", "Show status: what is installed?"),
         ("prepare", "Prepare installation of MPSD-release (dev only)"),
     ]