Bug 482382: API Removal Process is incomplete for removal of types
diff --git a/bundles/org.eclipse.platform.doc.isv/porting/removals.html b/bundles/org.eclipse.platform.doc.isv/porting/removals.html
index 3dc4891..6a524ad 100644
--- a/bundles/org.eclipse.platform.doc.isv/porting/removals.html
+++ b/bundles/org.eclipse.platform.doc.isv/porting/removals.html
@@ -22,6 +22,10 @@
   This section describes API removals that occurred in this release, and upcoming 
   removals in future releases.
 </p>
+<p>
+  <b>Note that the policy for removing API types is broken, so some of these plans are not implementable, see
+  <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=482382" target="_blank">bug 482382</a></b>.
+</p>
 
 <p>
 Removed APIs in the Neon (4.6) release: