diff --git a/schema/xos-core.yang b/schema/xos-core.yang
index b0d4eaf..82d1a7e 100644
--- a/schema/xos-core.yang
+++ b/schema/xos-core.yang
@@ -10,11 +10,28 @@
     "Larry Peterson <llp@onlab.us>
      Peter K. Lee <peter@corenova.com>";
   
+  description
+   "This module contains a collection of core models for XOS.
+
+    Copyright (c) 2016 ON.LAB and the persons identified as authors of
+    the code.  All rights reserved.
+
+    Redistribution and use in source and binary forms, with or without
+    modification, is permitted pursuant to, and subject to the license
+    terms of the Apache License, Version 2.0 which accompanies this
+    distribution, and is available at
+    (http://www.apache.org/licenses/LICENSE-2.0).";
+  
+  revision 2016-07-14 {
+    description "Initial revision.";
+  }
+  
   import ietf-yang-types { prefix yang; }
   import ietf-inet-types { prefix inet; }
 
-  revision 2016-07-14 {
-    description "Initial revision.";
+  feature synchronizer {
+    description
+      "Enables configuration synchronization to the distributed store.";
   }
   
   identity kind;
@@ -31,7 +48,6 @@
   }
 
   grouping tenant-root {
-
     description
       "A Tenant Root is one of the things that can sit at the root of a chain
        of tenancy. This object represents a node.";
@@ -63,7 +79,6 @@
       config false;
       // not exactly clear how this is populated
     }
-    
   }
   
   grouping subscriber {
@@ -71,22 +86,21 @@
       refine kind { default subscriber; }
     }
     // seems we should have interesting attributes specific to subscriber?
-    
   }
 
-  // main configuration tree for XOS
+  /*** main configuration tree for XOS ***/
 
   container api {
+    description
+      "The primary configuration interaction endpoint";
+    
     container service {
-      // placeholder endpoint for services
+      description
+        "placeholder endpoint for services to augment";
     }
     container tenant {
-      container cord {
-        // placeholder endpoint for augment
-      }
-      container onos {
-        // placeholder endpoint for augment
-      }
+      description
+        "placeholder endpoint for tenants to augment";
     }
   }