Updated schema docs and order of items

Author: slominskir

schemas/active-alarms-value.avsc

@@ -2,20 +2,22 @@
   "type": "record",
   "name": "ActiveAlarm",
   "namespace": "org.jlab.kafka.alarms",
+  "doc": "Alarms currently alarming",
   "fields": [
     {
       "name": "priority",
       "type": {
         "type": "enum",
         "name": "AlarmPriority",
-        "doc": "Alarm severity organized as a way for operators to prioritize which alarms to take action on first",
+        "doc": "Enumeration of possible alarm priorities",
         "symbols": [
           "P1_LIFE",
           "P2_PROPERTY",
           "P3_PRODUCTIVITY",
           "P4_DIAGNOSTIC"
         ]
-      }
+      },
+      "doc": "Alarm severity organized as a way for operators to prioritize which alarms to take action on first"
     },
     {
       "name": "acknowledged",

scripts/active-alarms/set-active.py

@@ -13,24 +13,27 @@
 
 value_schema_str = """
 {
-   "namespace" : "org.jlab.kafka.alarms",
-   "name"      : "ActiveAlarm",
    "type"      : "record",
+   "name"      : "ActiveAlarm",   
+   "namespace" : "org.jlab.kafka.alarms",
+   "doc"       : "Alarms currently alarming",
    "fields"    : [
      {
        "name"    : "priority",
        "type"    : {
-         "name"    : "AlarmPriority",
-         "type"    : "enum",
-         "symbols" : ["P1_LIFE","P2_PROPERTY","P3_PRODUCTIVITY", "P4_DIAGNOSTIC"],
-         "doc"     : "Alarm severity organized as a way for operators to prioritize which alarms to take action on first"
-       }
+         "type"      : "enum",       
+         "name"      : "AlarmPriority",
+         "namespace" : "org.jlab.kafka.alarms",
+         "doc"       : "Enumeration of possible alarm priorities",
+         "symbols"   : ["P1_LIFE","P2_PROPERTY","P3_PRODUCTIVITY", "P4_DIAGNOSTIC"]
+       },
+       "doc"     : "Alarm severity organized as a way for operators to prioritize which alarms to take action on first"
      },
      {
         "name"    : "acknowledged",
         "type"    : "boolean",
-        "default" : false,
-        "doc"     : "Indicates whether this alarm has been explicitly acknowledged - useful for latching alarms which can only be cleared after acknowledgement"
+        "doc"     : "Indicates whether this alarm has been explicitly acknowledged - useful for latching alarms which can only be cleared after acknowledgement",
+        "default" : false        
      }
   ]
 }