diff --git a/core/api/src/main/java/org/onosproject/net/pi/model/PiPipelineInterpreter.java b/core/api/src/main/java/org/onosproject/net/pi/model/PiPipelineInterpreter.java
index 9206f5c..cada0f9 100644
--- a/core/api/src/main/java/org/onosproject/net/pi/model/PiPipelineInterpreter.java
+++ b/core/api/src/main/java/org/onosproject/net/pi/model/PiPipelineInterpreter.java
@@ -64,6 +64,10 @@
      * @param flowRuleTableId a numeric table ID
      * @return PI table ID
      */
+    // FIXME: remove this method. The only place where this mapping seems useful
+    // is when using the default single table pipeliner which produces flow
+    // rules for table 0. Instead, PI pipeliners should provide a mapping to a
+    // specific PiTableId even when mapping to a single table.
     Optional<PiTableId> mapFlowRuleTableId(int flowRuleTableId);
 
     /**
@@ -75,6 +79,7 @@
      * @param piTableId PI table ID
      * @return numeric table ID
      */
+    // FIXME: as above
     Optional<Integer> mapPiTableId(PiTableId piTableId);
 
     /**