diff --git a/apps/newoptical/src/main/java/org/onosproject/newoptical/PacketLinkRealizedByOptical.java b/apps/newoptical/src/main/java/org/onosproject/newoptical/PacketLinkRealizedByOptical.java
index 52728fa..3425d36 100644
--- a/apps/newoptical/src/main/java/org/onosproject/newoptical/PacketLinkRealizedByOptical.java
+++ b/apps/newoptical/src/main/java/org/onosproject/newoptical/PacketLinkRealizedByOptical.java
@@ -57,7 +57,7 @@
      * @param src source connect point
      * @param dst destination connect point
      * @param intent OpticalCircuitIntent that realizes packet link between src and dst
-     * @return
+     * @return PacketLinkRealizedByOptical instance with specified connect points and OpticalCircuitIntent
      */
     public static PacketLinkRealizedByOptical create(ConnectPoint src, ConnectPoint dst,
                                                      OpticalCircuitIntent intent) {
@@ -76,7 +76,7 @@
      * @param src source connect point
      * @param dst destination connect point
      * @param intent OpticalConnectivityIntent that realizes packet link between src and dst
-     * @return
+     * @return PacketLinkRealizedByOptical instance with specified connect points and OpticalConnectivityIntent
      */
     public static PacketLinkRealizedByOptical create(ConnectPoint src, ConnectPoint dst,
                                                      OpticalConnectivityIntent intent) {
diff --git a/apps/newoptical/src/main/java/org/onosproject/newoptical/api/OpticalPathEvent.java b/apps/newoptical/src/main/java/org/onosproject/newoptical/api/OpticalPathEvent.java
index 95b87e6..a853d33 100644
--- a/apps/newoptical/src/main/java/org/onosproject/newoptical/api/OpticalPathEvent.java
+++ b/apps/newoptical/src/main/java/org/onosproject/newoptical/api/OpticalPathEvent.java
@@ -30,8 +30,9 @@
 
     /**
      * Creates OpticalPathEvent object with specified type and subject.
-     * @param type
-     * @param subject
+     *
+     * @param type type of event
+     * @param subject subject of the event
      */
     public OpticalPathEvent(Type type, OpticalConnectivityId subject) {
         super(type, subject);