diff --git a/notebooks/Agent-Close-Following.ipynb b/notebooks/Agent-Close-Following.ipynb
index b1542693c80d3ce026c90433eb6d789ea0bac40d..069052747e91dadea4c1ec0afd9475fe9d2fd9db 100644
--- a/notebooks/Agent-Close-Following.ipynb
+++ b/notebooks/Agent-Close-Following.ipynb
@@ -282,7 +282,13 @@
     "\n",
     "In the example below, agents 0 and 1 collide head on.  The other agents are spaced out behind them and collide into them in subsequent steps.\n",
     "\n",
-    "The deadlock status is now recorded in element 5 of each agent in the recorded episode.  (row, col, dir, status, malfunction, deadlock)"
+    "The deadlock status is now recorded in element 5 of each agent in the recorded episode.  (row, col, dir, status, malfunction, deadlock)\n",
+    "\n",
+    "__Bugs / Limitations__\n",
+    "\n",
+    "The code does not currently count agents which are deadlocked, if they are also malfunctioning, or choose to stop moving voluntarily.\n",
+    "\n",
+    "The code does not detect agents which are about to become deadlocked, because they are heading towards each other on a track with no junctions or relevant targets."
    ]
   },
   {