diff --git a/pom.xml b/pom.xml
index 018695656..0a184a269 100644
--- a/pom.xml
+++ b/pom.xml
@@ -209,6 +209,10 @@ Copyright (c) 2012 - Jeremy Long
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-site-plugin</artifactId>
+                    <!-- Before upgrading this to a newer version, verify the pages produced by `mvn site` still works.
+                    In particular, pay attention to all pages under "File type analyzers" as well as those under "General".
+                    Previously when testing with maven-site-plugin 3.4, these links have stopped working for some reason.
+                    -->
                     <version>3.3</version>
                 </plugin>
                 <plugin>