diff --git a/README.md b/README.md
index d469e22..fd48635 100644
--- a/README.md
+++ b/README.md
@@ -20,3 +20,12 @@
 HTrace is a tracing framework for use with distributed systems.
 
 See documentation at src/main/site/markdown/index.md or at http://htrace.incubator.apache.org.
+
+Building
+--------
+Only Maven 3.0.4 should be used to create HTrace releases - see [HTRACE-236](https://issues.apache.org/jira/browse/HTRACE-236)
+(Support building release artifacts with Maven versions other than 3.0.4) for details.  
+
+To get around this while using Maven 3.3 [HTRACE-234](https://issues.apache.org/jira/browse/HTRACE-234)
+you can run maven with `-DcreateDependencyReducedPom=false`.  
+
diff --git a/htrace-hbase/pom.xml b/htrace-hbase/pom.xml
index 20075e9..f2d0351 100644
--- a/htrace-hbase/pom.xml
+++ b/htrace-hbase/pom.xml
@@ -33,6 +33,7 @@
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <hbase.version>0.99.2</hbase.version>
     <jetty.version>9.2.13.v20150730</jetty.version>
+    <createDependencyReducedPom>true</createDependencyReducedPom>
   </properties>
 
   <build>
@@ -67,6 +68,9 @@
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-shade-plugin</artifactId>
+        <configuration>
+          <createDependencyReducedPom>${createDependencyReducedPom}</createDependencyReducedPom>
+        </configuration>
         <executions>
           <execution>
             <phase>package</phase>