move descriptions up (#9979)

Author: gewarren

.github/policies/assign-prs.yml

@@ -5,7 +5,8 @@ resource: repository
 configuration:
   resourceManagementConfiguration:
     eventResponderTasks:
-      - if:
+      - description: Assign team PRs to author
+        if:
         - payloadType: Pull_Request
         - isAction:
             action: Opened
@@ -15,4 +16,4 @@ configuration:
         then:
         - assignTo:
             author: True
-        description: Assign team PRs to author
+

.github/policies/author-action.yml

@@ -5,15 +5,17 @@ resource: repository
 configuration:
   resourceManagementConfiguration:
     eventResponderTasks:
-      - if:
+      - description: Needs-author-action notification
+        if:
         - payloadType: Issues
         - labelAdded:
             label: needs-author-action
         then:
         - addReply:
-            reply: This issue has been marked `needs-author-action` and may be missing some important information.
-        description: Needs-author-action notification
-      - if:
+            reply: This issue has been marked `needs-author-action` and might be missing some important information.
+
+      - description: PR reviews with "changes requested" applies the needs-author-action label
+        if:
         - payloadType: Pull_Request_Review
         - not:
             activitySenderHasPermission:
@@ -25,8 +27,9 @@ configuration:
         then:
         - addLabel:
             label: needs-author-action
-        description: PR reviews with "changes requested" applies the needs-author-action label
-      - if:
+
+      - description: Replace `needs-author-action` label with `needs-further-triage` label when the author comments on an issue that's not "untriaged"
+        if:
         - payloadType: Issue_Comment
         - isAction:
             action: Created
@@ -43,8 +46,9 @@ configuration:
             label: needs-further-triage
         - removeLabel:
             label: needs-author-action
-        description: Replace `needs-author-action` label with `needs-further-triage` label when the author comments on an issue that is not still untriaged
-      - if:
+
+      - description: Remove `needs-author-action` label when the author comments on an `untriaged` issue
+        if:
         - payloadType: Issue_Comment
         - isAction:
             action: Created
@@ -58,8 +62,9 @@ configuration:
         then:
         - removeLabel:
             label: needs-author-action
-        description: Remove `needs-author-action` label when the author comments on an `untriaged` issue
-      - if:
+
+      - description: Pushing changes to PR branch removes the needs-author-action label
+        if:
         - payloadType: Pull_Request
         - isAction:
             action: Synchronize
@@ -68,8 +73,9 @@ configuration:
         then:
         - removeLabel:
             label: needs-author-action
-        description: Pushing changes to PR branch removes the needs-author-action label
-      - if:
+
+      - description: Author commenting in PR removes the needs-author-action label
+        if:
         - payloadType: Issue_Comment
         - isActivitySender:
             issueAuthor: True
@@ -81,8 +87,9 @@ configuration:
         then:
         - removeLabel:
             label: needs-author-action
-        description: Author commenting in PR removes the needs-author-action label
-      - if:
+
+      - description: Author responding to a PR review comment removes the needs-author-action label
+        if:
         - payloadType: Pull_Request_Review
         - isActivitySender:
             issueAuthor: True
@@ -94,4 +101,3 @@ configuration:
         then:
         - removeLabel:
             label: needs-author-action
-        description: Author responding to a pull request review comment removes the needs-author-action label

.github/policies/community-contrib.yml

@@ -5,7 +5,8 @@ resource: repository
 configuration:
   resourceManagementConfiguration:
     eventResponderTasks:
-      - if:
+      - description: Label community PRs
+        if:
         - payloadType: Pull_Request
         - isAction:
             action: Opened
@@ -46,4 +47,3 @@ configuration:
         then:
         - addLabel:
             label: community-contribution
-        description: Label community PRs

.github/policies/scheduled-pr.yml

@@ -5,7 +5,8 @@ resource: repository
 configuration:
   resourceManagementConfiguration:
     scheduledSearches:
-      - frequencies:
+      - description: Push to live branch (publish)
+        frequencies:
           - daily:
               time: 08:0
         filters: []
@@ -15,5 +16,4 @@ configuration:
               base: live
               title: Merge main into live
               body: Please don't squash-merge this PR.
-        description: Push to live branch (publish)
 

.github/policies/untriaged-label.yml

@@ -6,7 +6,8 @@ resource: repository
 configuration:
   resourceManagementConfiguration:
     eventResponderTasks:
-    - if:
+    - description: Add untriaged label to new/reopened issues without a milestone
+      if:
       - payloadType: Issues
       - isOpen
       - not:
@@ -22,8 +23,9 @@ configuration:
       then:
       - addLabel:
           label: untriaged
-      description: Add untriaged label to new/reopened issues without a milestone
-    - if:
+
+    - description: Remove untriaged label from issues when closed or added to a milestone
+      if:
       - payloadType: Issues
       - or:
         - isAction:
@@ -34,4 +36,3 @@ configuration:
       then:
       - removeLabel:
           label: untriaged
-      description: Remove untriaged label from issues when closed or added to a milestone