Index: chapter.xml
===================================================================
--- chapter.xml
+++ chapter.xml
@@ -1232,6 +1232,17 @@
 	  alternative.</para>
 
 	<note>
+	  <para>Although <application>portmaster</application> and
+	    <application>portupgrade</application> appear on the surface
+	    to be lightweight and simple to deploy, the probability of
+	    build failures that nobody else can replicate is
+	    exceptionally high.  If you are not prepared to diagnose and
+	    fix build failures due to environment contamination, you are
+	    strongly urged to use <application>poudriere</application>
+	    or FreeBSD-provided packages.</para>
+	</note>
+
+	<note>
 	  <para>The choice of which tool is best for a particular
 	    system is up to the system administrator.  It is
 	    recommended practice to back up your data before using any