3 files changed, 14 insertions, 6 deletions
diff --git a/acl/acl-api/src/main/yang/interface-acl@2016-12-14.yang b/acl/acl-api/src/main/yang/interface-acl@2016-12-14.yang
index a54e3d8d4..f051830fe 100644
--- a/acl/acl-api/src/main/yang/interface-acl@2016-12-14.yang
+++ b/acl/acl-api/src/main/yang/interface-acl@2016-12-14.yang
@@ -23,7 +23,9 @@ module interface-acl {
      Mailing List <hc2vpp@lists.fd.io>";
 
   description
-    "Provides augmentations to ietf-interfaces model for assigning ACLs via ACL plugin of VPP.
+    "This module contains a collection of YANG definitions for
+     applying ACLs on VPP interfaces.
+     Uses ACL implementation provided by ACL plugin of VPP.
 
      Copyright (c) 2016 Cisco and/or its affiliates.
 
@@ -43,7 +45,7 @@ module interface-acl {
     description "Initial revision of interface-acl model";
   }
 
-  grouping vpp-acls-base-attributes  {
+  grouping vpp-acls-base-attributes {
     description
       "List of ACLs of vpp-acl type"; // TODO(HC2VPP-201): express constraint in the model if possible
     list vpp-acls {
@@ -61,7 +63,7 @@ module interface-acl {
     }
   }
 
-  grouping vpp-macip-acls-base-attributes  {
+  grouping vpp-macip-acls-base-attributes {
     container vpp-macip-acl {
       description
         "ACL of vpp-macip-acl type"; // TODO(HC2VPP-201): express constraint in the model if possible
diff --git a/acl/acl-api/src/main/yang/vpp-acl-context@2017-01-04.yang b/acl/acl-api/src/main/yang/vpp-acl-context@2017-01-04.yang
index f965f6eed..016883e1e 100644
--- a/acl/acl-api/src/main/yang/vpp-acl-context@2017-01-04.yang
+++ b/acl/acl-api/src/main/yang/vpp-acl-context@2017-01-04.yang
@@ -19,8 +19,12 @@ module vpp-acl-context {
          Mailing List <hc2vpp@lists.fd.io>";
 
     description
-        "Provides mapping between YANG identifiers (names)
-         and identifiers used by VPP ACL plugin.
+        "This module provides mapping between ACL identifiers
+         defined in the ietf-access-control-list module
+         and identifiers used by the VPP ACL plugin.
+
+         The mapping is managed internally by the HC ACL plugin.
+         It is exposed as operational state data for debugging purposes.
 
          Copyright (c) 2017 Cisco and/or its affiliates.
 
diff --git a/acl/acl-api/src/main/yang/vpp-acl@2017-06-15.yang b/acl/acl-api/src/main/yang/vpp-acl@2017-06-15.yang
index dffab79eb..f681724a9 100644
--- a/acl/acl-api/src/main/yang/vpp-acl@2017-06-15.yang
+++ b/acl/acl-api/src/main/yang/vpp-acl@2017-06-15.yang
@@ -31,7 +31,9 @@ module vpp-acl {
      Mailing List <hc2vpp@lists.fd.io>";
 
   description
-    "Provides augmentations to ietf-access-control-list exposing VPP specific features of the VPP ACL plugin.
+    "This module contains a collection of YANG definitions
+     that extend ietf-access-control-list module
+     with VPP specific features provided by the VPP ACL plugin.
 
      Copyright (c) 2016 Cisco and/or its affiliates.