diff --git a/.circleci/config.yml b/.circleci/config.yml
index ba44e8040edfefb6ce2a32f9c2814e116bbafa98..c6d31b6c79c88bc51a6d80e1e9b0d55347c18b63 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -78,6 +78,11 @@ jobs:
           # Build just our dependencies.  It's nice to have this as a separate
           # step so failures here are more easily identified as being
           # unrelated to our code.
+          #
+          # See below for explanation of the various flags passed in.  If the
+          # flags here differ from those below in a way that makes ghc think a
+          # library needs to be rebuilt then we'll build everything twice and
+          # our cache will be useless!  Try not to make that happen.
           name: "Build Dependencies"
           command: |
             BUILD="stack build \