diff --git a/src/main.tf b/src/main.tf
index 0212e1e..1de06dd 100644
--- a/src/main.tf
+++ b/src/main.tf
@@ -24,6 +24,10 @@ locals {
     }
   }
 
+  # Managed files. Terraform overwrites these on every run, so repositories
+  # cannot diverge from the template - changes must be made upstream here.
+  # Contrast with seeded_files below; the only thing separating the two
+  # categories is which local a file is placed in.
   files = {
     ".github/workflows/sanity_checks.yml" = {
       content = file("templates/all/.github/workflows/sanity_checks.yml")
diff --git a/src/templates/all/.cspell.config.yaml b/src/templates/all/.cspell.config.yaml
index ccb7347..a07e10e 100644
--- a/src/templates/all/.cspell.config.yaml
+++ b/src/templates/all/.cspell.config.yaml
@@ -1,7 +1,9 @@
 ---
-## DO NOT EDIT!
-# This file was provisioned by Terraform
-# File origin: https://github.com/Arrow-air/tf-github/tree/main/src/templates/all/.cspell.config.yaml
+## SEEDED FILE - this repository owns it.
+# Terraform wrote this file once, when the repository was created, and will not
+# update it again. Local changes are preserved. Edit it freely.
+# Upstream default: https://github.com/Arrow-air/tf-github/tree/main/src/templates/all/.cspell.config.yaml
+# Changing the upstream default affects newly created repositories only.
 
 $schema: https://raw.githubusercontent.com/streetsidesoftware/cspell/main/cspell.schema.json
 version: "0.2"