diff --git a/_config.yml b/_config.yml
index fc3135b..1c2c02e 100644
--- a/_config.yml
+++ b/_config.yml
@@ -19,23 +19,31 @@ ga_tracking_anonymize_ip: true
 
 callouts_level: quiet # or loud
 callouts:
-  highlight:
-    color: blue
-  important:
-    title: Important
+# use for documentation still not fully complete, but partially launched
+  construction:
+    title: Under Construction
     color: yellow
+# use after launching new documentation for external staff, remove after some period time
   new:
     title: New
     color: green
+# use for legacy instruction that will eventually be removed, remove when documentation is removed
+  deprecated:
+    title: Deprecated
+    color: red
+# use to callout requirements before starting process
+  important:
+    title: Important
+    color: yellow
+# use for context to instructions
   note:
     title: Note
     color: purple
+# use for situations where no further work should be completed until situation is resolved
   warning:
     title: Warning
     color: red
-  construction:
-    title: Under Construction
-    color: yellow
-  deprecated:
-    title: Deprecated
-    color: red
\ No newline at end of file
+# use for final instruction or failure remediation
+  highlight:
+    color: blue
+