diff --git a/core/net/src/main/java/org/onosproject/net/intent/impl/Compiling.java b/core/net/src/main/java/org/onosproject/net/intent/impl/Compiling.java
index 0673ee4..bf4079f 100644
--- a/core/net/src/main/java/org/onosproject/net/intent/impl/Compiling.java
+++ b/core/net/src/main/java/org/onosproject/net/intent/impl/Compiling.java
@@ -26,6 +26,9 @@
 
 import static com.google.common.base.Preconditions.checkNotNull;
 
+/**
+ * Represents a phase where an intent is being compiled.
+ */
 class Compiling implements IntentUpdate {
 
     private static final Logger log = LoggerFactory.getLogger(Compiling.class);
diff --git a/core/net/src/main/java/org/onosproject/net/intent/impl/InstallRequest.java b/core/net/src/main/java/org/onosproject/net/intent/impl/InstallRequest.java
index 52e8bc1..ebc49fc 100644
--- a/core/net/src/main/java/org/onosproject/net/intent/impl/InstallRequest.java
+++ b/core/net/src/main/java/org/onosproject/net/intent/impl/InstallRequest.java
@@ -21,7 +21,9 @@
 
 import static com.google.common.base.Preconditions.checkNotNull;
 
-// TODO pull out the IntentUpdate inner classes
+/**
+ * Represents a phase where intent installation has been requested.
+ */
 class InstallRequest implements IntentUpdate {
 
     // TODO: define an interface and use it, instead of IntentManager
diff --git a/core/net/src/main/java/org/onosproject/net/intent/impl/Installed.java b/core/net/src/main/java/org/onosproject/net/intent/impl/Installed.java
index 8b9971f..1a2dea9 100644
--- a/core/net/src/main/java/org/onosproject/net/intent/impl/Installed.java
+++ b/core/net/src/main/java/org/onosproject/net/intent/impl/Installed.java
@@ -20,6 +20,9 @@
 import static com.google.common.base.Preconditions.checkNotNull;
 import static org.onosproject.net.intent.IntentState.INSTALLING;
 
+/**
+ * Represent a phase where an intent has been installed.
+ */
 class Installed extends CompletedIntentUpdate {
 
     private final IntentData intentData;
diff --git a/core/net/src/main/java/org/onosproject/net/intent/impl/Withdrawn.java b/core/net/src/main/java/org/onosproject/net/intent/impl/Withdrawn.java
index c7e531a..e5e4acd 100644
--- a/core/net/src/main/java/org/onosproject/net/intent/impl/Withdrawn.java
+++ b/core/net/src/main/java/org/onosproject/net/intent/impl/Withdrawn.java
@@ -21,6 +21,9 @@
 import static com.google.common.base.Preconditions.checkNotNull;
 import static org.onosproject.net.intent.IntentState.WITHDRAWING;
 
+/**
+ * Represents a phase where an intent has been withdrawn.
+ */
 class Withdrawn extends CompletedIntentUpdate {
 
     private final IntentData intentData;