From 81b56386d7bc23668cf771c72edb9835a943b2b7 Mon Sep 17 00:00:00 2001
From: Tom Prince <tom.prince@private.storage>
Date: Mon, 6 Sep 2021 13:57:37 -0600
Subject: [PATCH] Add a comment about merging modules and base.nix.

---
 morph/lib/base.nix   |  1 +
 morph/lib/issuer.nix | 12 ++++++------
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/morph/lib/base.nix b/morph/lib/base.nix
index 35f1182b..809e3556 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 5c348280..a14d70e0 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;
-- 
GitLab