diff --git a/yang/appendix-a-examples b/yang/appendix-a-examples
index 3281fc6..65720fb 100644
--- a/yang/appendix-a-examples
+++ b/yang/appendix-a-examples
@@ -7,9 +7,15 @@ module example-sch-usage-1 {
     prefix "schedule";
   }
 
-  organization "Example, Inc.";
-  contact "Support at example.com";
-  description "An example.";
+  organization 
+    "Example, Inc.";
+
+  contact
+    "Support at example.com";
+
+  description
+    "Example of a module using 'generic-schedule-params' and
+     'schedule-status' groupings.";
 
   revision "2026-02-20" {
     description "Initial version.";
@@ -18,11 +24,13 @@ module example-sch-usage-1 {
   }
 
   container generic-schedule-params {
-    description "A description.";
+    description 
+      "A collection of generic scheduling parameters.";
     uses schedule:generic-schedule-params;
   }
   container schedule-status {
-    description "A description.";
+    description 
+      "A collection of scheduling status.";
     uses schedule:schedule-status;
   }
 }
@@ -32,9 +40,18 @@ module example-sch-usage-2 {
   namespace "http://example.com/example-sch-usage-2";
   prefix "ex-schu2";
 
-  organization "Example, Inc.";
-  contact "Support at example.com";
-  description "An example.";
+  import ietf-schedule {
+    prefix "schedule";
+  }  
+
+  organization 
+    "Example, Inc.";
+
+  contact
+    "Support at example.com";
+
+  description
+    "Example of a module using the 'period-of-time' grouping.";
 
   revision "2026-02-20" {
     description "Initial version.";
@@ -42,12 +59,9 @@ module example-sch-usage-2 {
       "RFC 9922: A YANG Data Model for Scheduling.";
   }
 
-  import ietf-schedule {
-    prefix "schedule";
-  }
-
   container period-of-time {
-    description "A description.";
+    description 
+      "A container for a time period.";
     uses schedule:period-of-time;
   }
 }
@@ -61,9 +75,14 @@ module example-sch-usage-3 {
     prefix "schedule";
   }
 
-  organization "Example, Inc.";
-  contact "Support at example.com";
-  description "An example.";
+  organization 
+    "Example, Inc.";
+
+  contact
+    "Support at example.com";
+
+  description
+    "Example of a module using the 'recurrence-basic' grouping.";
 
   revision "2026-02-20" {
     description "Initial version.";
@@ -72,12 +91,9 @@ module example-sch-usage-3 {
   }
 
   container recurrence-basic {
-    description "A description.";
+    description 
+      "A container for a simple recurrence rule.";
     uses schedule:recurrence-basic {
-      description "A description.";
-      refine frequency {
-        mandatory true;
-      }
       refine interval {
         default 1;
       }
@@ -94,9 +110,14 @@ module example-sch-usage-4 {
     prefix "schedule";
   }
 
-  organization "Example, Inc.";
-  contact "Support at example.com";
-  description "An example.";
+  organization 
+    "Example, Inc.";
+
+  contact
+    "Support at example.com";
+
+  description
+    "Example of a module using the 'recurrence-utc' grouping.";
 
   revision "2026-02-20" {
     description "Initial version.";
@@ -105,7 +126,8 @@ module example-sch-usage-4 {
   }
 
   container recurrence-utc {
-    description "A description.";
+    description 
+      "A container for a simple recurrence rule in UTC format.";
     uses schedule:recurrence-utc;
   }
 }
@@ -119,9 +141,15 @@ module example-sch-usage-5 {
     prefix "schedule";
   }
 
-  organization "Example, Inc.";
-  contact "Support at example.com";
-  description "An example.";
+  organization 
+    "Example, Inc.";
+
+  contact
+    "Support at example.com";
+
+  description
+    "Example of a module using the 'recurrence-with-time-zone'
+     grouping.";
 
   revision "2026-02-20" {
     description "Initial version.";
@@ -130,7 +158,8 @@ module example-sch-usage-5 {
   }
 
   container recurrence-with-time-zone {
-    description "A description.";
+    description 
+      "A container for a simple recurrence rule with a time zone.";
     uses schedule:recurrence-with-time-zone;
   }
 }
@@ -144,9 +173,15 @@ module example-sch-usage-6 {
     prefix "schedule";
   }
 
-  organization "Example, Inc.";
-  contact "Support at example.com";
-  description "An example.";
+  organization 
+    "Example, Inc.";
+
+  contact
+    "Support at example.com";
+
+  description
+    "Example of a module using the 'recurrence-utc-with-periods'
+     grouping.";
 
   revision "2026-02-20" {
     description "Initial version.";
@@ -154,8 +189,10 @@ module example-sch-usage-6 {
       "RFC 9922: A YANG Data Model for Scheduling.";
   }
 
-  container recurrence-utc-with-date-times {
-    description "A description.";
+  container recurrence-utc-with-periods {
+    description
+      "A container for an aggregate set of repeating occurrences in
+       UTC format.";
     uses schedule:recurrence-utc-with-periods;
   }
 }
@@ -169,9 +206,15 @@ module example-sch-usage-7 {
     prefix "schedule";
   }
 
-  organization "Example, Inc.";
-  contact "Support at example.com";
-  description "An example.";
+  organization 
+    "Example, Inc.";
+
+  contact
+    "Support at example.com";
+
+  description
+    "Example of a module using the 'recurrence-time-zone-with-periods'
+     grouping.";
 
   revision "2026-02-20" {
     description "Initial version.";
@@ -179,8 +222,10 @@ module example-sch-usage-7 {
       "RFC 9922: A YANG Data Model for Scheduling.";
   }
 
-  container recurrence-time-zone-with-date-times {
-    description "A description.";
+  container recurrence-time-zone-with-periods {
+    description
+      "A container for an aggregate set of repeating occurrences
+       with a time zone.";
     uses schedule:recurrence-time-zone-with-periods;
   }
 }
@@ -194,9 +239,14 @@ module example-sch-usage-8 {
     prefix "schedule";
   }
 
-  organization "Example, Inc.";
-  contact "Support at example.com";
-  description "An example.";
+  organization 
+    "Example, Inc.";
+
+  contact
+    "Support at example.com";
+
+  description
+    "Example of a module using 'icalendar-recurrence' grouping.";
 
   revision "2026-02-20" {
     description "Initial version.";
@@ -205,9 +255,9 @@ module example-sch-usage-8 {
   }
 
   container icalendar-recurrence {
-    description "A description.";
+    description 
+      "A container for a scheduled iCalendar recurrence.";
     uses schedule:icalendar-recurrence {
-      description "A description.";
       refine workweek-start {
         default monday;
       }
diff --git a/yang/example-sch-capacity-res.yang b/yang/example-sch-capacity-res.yang
index 7da558d..e20c362 100644
--- a/yang/example-sch-capacity-res.yang
+++ b/yang/example-sch-capacity-res.yang
@@ -11,18 +11,44 @@ module example-sch-capacity-res {
     prefix "schedule";
   }
 
+  organization
+    "Example, Inc.";
+
+  contact
+    "Support at example.com";
+
+  description
+    "An example to show a scheduled link capacity reservation.";
+
+  revision "2026-02-20" {
+    description
+      "Initial version.";
+    reference
+      "RFC 9922: A YANG Data Model for Scheduling";
+  }
+
   container link-capability-reservations {
+    description
+      "A container for a scheduled link capability reservations";
     list scheduled-link-capacity {
       key "schedule-id";
+      description
+        "Definition of scheduled link capacity list";
       leaf schedule-id {
         type string;
+        description
+          "The schedule identifier for this schedule rule.";
       }
       leaf link-id {
         type nt:link-id;
+        description
+          "The identifier of a link in the topology.";
       }
       leaf reserved-capability {
         type uint64;
         units "Mbps";
+        description
+          "The reserved capability for a particular link.";
       }
       uses schedule:period-of-time;
     }