diff --git a/shell/common/switches.h b/shell/common/switches.h
index d80e942783355da04b840a73fb436db049da9dc5..290d56d31d4e90c31c8d6e1e6d0c09b5452b8a41 100644
--- a/shell/common/switches.h
+++ b/shell/common/switches.h
@@ -49,7 +49,11 @@ DEF_SWITCH(IsolateSnapshotInstructions,
            "isolate-snapshot-instr",
            "The isolate instructions snapshot that will be memory mapped as "
            "read and executable. SnapshotAssetPath must be present.")
-DEF_SWITCH(CacheDirPath, "cache-dir-path", "Path to the cache directory.")
+DEF_SWITCH(CacheDirPath,
+           "cache-dir-path",
+           "Path to the cache directory. "
+           "This is different from the persistent_cache_path in embedder.h, "
+           "which is used for Skia shader cache.")
 DEF_SWITCH(ICUDataFilePath, "icu-data-file-path", "Path to the ICU data file.")
 DEF_SWITCH(ICUSymbolPrefix,
            "icu-symbol-prefix",
diff --git a/shell/platform/embedder/embedder.h b/shell/platform/embedder/embedder.h
index 2d6e4205e35d5bdd55db42c70d12189484dac77c..f0107676e442528fae975d2812159a42f4b09a74 100644
--- a/shell/platform/embedder/embedder.h
+++ b/shell/platform/embedder/embedder.h
@@ -653,6 +653,9 @@ typedef struct {
   // Path to a directory used to store data that is cached across runs of a
   // Flutter application (such as compiled shader programs used by Skia).
   // This is optional.  The string must be NULL terminated.
+  //
+  // This is different from the cache-path-dir argument defined in switches.h,
+  // which is used in |flutter::Settings| as |temp_directory_path|.
   const char* persistent_cache_path;
 
   // If true, we'll only read the existing cache, but not write new ones.