diff --git a/morph/lib/base.nix b/morph/lib/base.nix
index 35f1182b7378a5f9c34512885719f8756b2fde19..809e3556c534c55890520d81d3e3383cc0b18f85 100644
--- a/morph/lib/base.nix
+++ b/morph/lib/base.nix
@@ -1,3 +1,4 @@
+# This module contains settings and configuration that apply to all nodes in a grid.
 { lib, config, ...}:
 {
   options.grid = {
diff --git a/morph/lib/issuer.nix b/morph/lib/issuer.nix
index 5c3482800da0afc34761f4ac3796789077c20bcb..a14d70e0634ad150d3c076abcdfc36fb6a167513 100644
--- a/morph/lib/issuer.nix
+++ b/morph/lib/issuer.nix
@@ -1,9 +1,9 @@
-# This is all of the static NixOS system configuration necessary to specify an
-# "issuer"-type system.  The configuration has various holes in it which must
-# be filled somehow.  These holes correspond to configuration which is not
-# statically known.  This value is suitable for use as a module to be imported
-# into a more complete system configuration.  It is expected that the holes
-# will be filled by a sibling module created by ``customize-issuer.nix``.
+# This, along with `customize-issuer.nix, contains all of the NixOS system
+# configuration necessary to specify an "issuer"-type system.  Originally, this
+# file has all the static configuration, and `customize-issuer.nix` was a function
+# that filled in the holes. We are in the process of merging the modules, using settings
+# instead of function arguments.
+# See https://whetstone.privatestorage.io/privatestorage/PrivateStorageio/-/issues/80
 { config, ...}:
 let
   inherit (config.grid) publicKeyPath privateKeyPath;