diff --git a/jboss/plugin.jelly b/jboss/plugin.jelly
index f47d8a27..7c7229e0 100644
--- a/jboss/plugin.jelly
+++ b/jboss/plugin.jelly
@@ -173,7 +173,18 @@
 
   <!--
      ========================================================================
-       Various deploy/undeploy goals
+       Various deploy/undeploy goals.
+       
+       Note: The war plugin's war:webapp goal will create an exploded warfile
+       at ${maven.build.dir}/${pom.artifactId}. If you want to deploy
+       that then it really should be ${maven.build.dir}/${pom.artifactId}.war.
+       Thus, in your project.properties, you should set maven.war.webapp.dir
+       to ${maven.build.dir}/${pom.artifactId}.war. In an ideal world that
+       would be the default value. I'm not sure why it isn't and I don't
+       want to change it because someone may be relying on the existing
+       behavior.
+       
+       You have been warned!         
      ========================================================================
   -->
   <goal name="jboss:deploy-exploded-warfile" prereqs="war:webapp"