Merge branch 'public' into workflows-test

Author: dstrome

.acrolinx-config.edn

@@ -35,7 +35,7 @@ If you need a scoring exception for content in this PR, add the *Sign off* and t
 - Escalate the exception request to the Acrolinx Review Team for review.
 - Approve the exception and work with the GitHub Admin Team to merge the PR to the default branch.
 
-For more information about the exception criteria and exception process, see [Minimum Acrolinx topic scores for publishing](https://review.docs.microsoft.com/en-us/office-authoring-guide/acrolinx-min-score?branch=main).
+For more information about the exception criteria and exception process, see [Minimum Acrolinx topic scores for publishing](https://review.learn.microsoft.com/en-us/office-authoring-guide/acrolinx-min-score?branch=main).
  
 Select the total score link to review all feedback on clarity, consistency, tone, brand, terms, spelling, grammar, readability, and inclusive language. _You should fix all spelling errors regardless of your total score_. Fixing spelling errors helps maintain customer trust in overall content quality.
 
@@ -51,10 +51,10 @@ Select the total score link to review all feedback on clarity, consistency, tone
  "
 **More information about Acrolinx**
  
-- [Install Acrolinx locally for VSCode for Magic](https://review.docs.microsoft.com/office-authoring-guide/acrolinx-vscode?branch=main)
+- [Install Acrolinx locally for VSCode for Magic](https://review.learn.microsoft.com/en-us/office-authoring-guide/acrolinx-vscode?branch=main)
 - [False positives or issues](https://aka.ms/acrolinxbug)
 - [Request a new Acrolinx term](https://microsoft.sharepoint.com/teams/M365Dev2/SitePages/M365-terminology.aspx)
-- [Troubleshooting issues with Acrolinx](https://review.docs.microsoft.com/help/contribute/acrolinx-error-messages)
+- [Troubleshooting issues with Acrolinx](https://review.learn.microsoft.com/en-us/help/platform/acrolinx-troubleshoot?branch=main)
 
 "
 }

.github/copilot-instructions.md

@@ -0,0 +1,55 @@
+# Copilot Instructions for Microsoft Learn
+ 
+These instructions define a unified style and process standard for authoring and maintaining learn.microsoft.com documentation with GitHub Copilot or other AI assistance.
+ 
+## Learn-wide Instructions
+ 
+Below are instructions that apply to all Microsoft Learn documentation authored with AI assistance. Learn product team will update this periodically as needed. Each repository SHOULD NOT update this to avoid being overwritten, but update the repository-specific instructions below as needed.
+ 
+### AI Usage & Disclosure
+All Markdown content created or substantially modified with AI assistance must include an `ai-usage` front matter entry:
+- `ai-usage: ai-generated` – AI produced the initial draft with minimal human authorship
+- `ai-usage: ai-assisted` – Human-directed, reviewed, and edited with AI support
+- Omit only for purely human-authored legacy content
+ 
+If missing, **add it**. However, do not add or update the ai-usage tag if the changes proposed are confined solely to:
+- Links (link text and/or URLs)
+- Single words or short phrases, such as entries in table cells
+- Less than 5% of the article's word count
+ 
+### Writing Style
+ 
+Follow [Microsoft Writing Style Guide](https://learn.microsoft.com/style-guide/welcome/) with these specifics:
+ 
+#### Voice and Tone
+ 
+- Active voice, second person addressing reader directly
+- Conversational tone with contractions
+- Present tense for instructions/descriptions
+- Imperative mood for instructions ("Call the method" not "You should call the method")
+- Use "might" instead of "may" for possibility
+- Avoid "we"/"our" referring to documentation authors
+ 
+#### Structure and Format
+ 
+- Sentence case headings (no gerunds in titles)
+- Be concise, break up long sentences
+- Oxford comma in lists
+- Number all ordered list items as "1." (not sequential numbering like "1.", "2.", "3.", etc.)
+- Complete sentences with proper punctuation in all list items
+- Avoid "etc." or "and so on" - provide complete lists or use "for example"
+- No consecutive headings without content between them
+ 
+#### Formatting Conventions
+ 
+- **Bold** for UI elements
+- `Code style` for file names, folders, custom types, non-localizable text
+- Raw URLs in angle brackets
+- Use relative links for files in this repo
+- Remove `https://learn.microsoft.com/en-us` from learn.microsoft.com links
+ 
+## Repository-Specific Instructions
+ 
+Below are instructions specific to this repository. These may be updated by repository maintainers as needed.
+ 
+<!--- Add additional repository level instructions below. Do NOT update this line or above. --->

.github/workflow-config.json

@@ -0,0 +1,27 @@
+{
+  "AutoIssueAssign": {
+    "ExcludedUserList": ["user1", "user2"]
+  },
+  "AutoLabelAssign": {
+    "AutoAssignUsers": 1,
+    "AutoAssignReviewers": 1,
+    "AutoLabel": 1,
+    "ExcludedUserList": ["user1", "user2"],
+    "ExcludedBranchList": ["branch1", "branch2"]
+  },
+  "AutoPublish": {
+    "EnableAutoPublish": true,
+    "EnableAutoMerge": true
+  },
+  "Stale": {
+    "RunDebug": false
+  },
+  "StaleBranch": {
+    "RepoBranchSkipList": ["ExampleBranch1", "ExampleBranch2"],
+    "ReportOnly": false
+  },
+  "TierManagement": {
+    "EnableWriteSignOff": 1,
+    "EnableReadOnlySignoff": 1
+  }
+}

.github/workflows/AutoIssueAssign.yml

@@ -0,0 +1,42 @@
+name: (Scheduled) Auto issue assign
+
+permissions:
+  contents: read
+  issues: write
+      
+on:
+  schedule:
+    - cron: "26 21 * * *"
+
+  workflow_dispatch:
+  
+
+jobs:
+
+  config:
+    if: github.repository_owner == 'MicrosoftDocs'
+    runs-on: ubuntu-latest
+    outputs:
+      ExcludedUserList: ${{ steps.read.outputs.ExcludedUserList }}
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          sparse-checkout: .github/workflow-config.json
+          sparse-checkout-cone-mode: false
+      - id: read
+        shell: pwsh
+        run: |
+          $Config = (Get-Content '.github/workflow-config.json' | ConvertFrom-Json).AutoIssueAssign
+          "ExcludedUserList=$($Config.ExcludedUserList | ConvertTo-Json -Compress)" >> $Env:GITHUB_OUTPUT
+
+  stale-branch:
+    if: github.repository_owner == 'MicrosoftDocs'
+    needs: config
+    uses: MicrosoftDocs/tcp-workflows/.github/workflows/Shared-AutoIssueAssign.yml@workflows-prod
+    with:
+        PayloadJson: ${{ toJSON(github) }}
+        ExcludedUserList: ${{ needs.config.outputs.ExcludedUserList }}
+    secrets:
+        AccessToken: ${{ secrets.GITHUB_TOKEN }}
+        PrivateKey: ${{ secrets.M365_APP_PRIVATE_KEY }}
+        ClientId: ${{ secrets.M365_APP_CLIENT_ID }}

.github/workflows/AutoLabelAssign.yml

@@ -12,10 +12,34 @@ on:
             - completed
 
 jobs:
+    config:
+        if: github.repository_owner == 'MicrosoftDocs'
+        runs-on: ubuntu-latest
+        outputs:
+            AutoAssignUsers: ${{ steps.read.outputs.AutoAssignUsers }}
+            AutoAssignReviewers: ${{ steps.read.outputs.AutoAssignReviewers }}
+            AutoLabel: ${{ steps.read.outputs.AutoLabel }}
+            ExcludedUserList: ${{ steps.read.outputs.ExcludedUserList }}
+            ExcludedBranchList: ${{ steps.read.outputs.ExcludedBranchList }}
+        steps:
+            - uses: actions/checkout@v5
+              with:
+                sparse-checkout: .github/workflow-config.json
+                sparse-checkout-cone-mode: false
+            - id: read
+              shell: pwsh
+              run: |
+                $Config = (Get-Content '.github/workflow-config.json' | ConvertFrom-Json).AutoLabelAssign
+                "AutoAssignUsers=$($Config.AutoAssignUsers)" >> $Env:GITHUB_OUTPUT
+                "AutoAssignReviewers=$($Config.AutoAssignReviewers)" >> $Env:GITHUB_OUTPUT
+                "AutoLabel=$($Config.AutoLabel)" >> $Env:GITHUB_OUTPUT
+                "ExcludedUserList=$($Config.ExcludedUserList | ConvertTo-Json -Compress)" >> $Env:GITHUB_OUTPUT
+                "ExcludedBranchList=$($Config.ExcludedBranchList | ConvertTo-Json -Compress)" >> $Env:GITHUB_OUTPUT
+
     download-payload:
         name: Download and extract payload artifact
         if: github.repository_owner == 'MicrosoftDocs'
-        uses: MicrosoftDocs/microsoft-365-docs/.github/workflows/Shared-ExtractPayload.yml@workflows-prod
+        uses: MicrosoftDocs/tcp-workflows/.github/workflows/Shared-ExtractPayload.yml@workflows-prod
         with:
             WorkflowId: ${{ github.event.workflow_run.id }}
             OrgRepo: ${{ github.repository }}
@@ -25,13 +49,18 @@ jobs:
     label-assign:
         name: Run assign and label
         if: github.repository_owner == 'MicrosoftDocs'
-        needs: [download-payload]
-        uses: MicrosoftDocs/microsoft-365-docs/.github/workflows/Shared-AutoLabelAssign.yml@workflows-prod
+        needs: [config, download-payload]
+        uses: MicrosoftDocs/tcp-workflows/.github/workflows/Shared-AutoLabelAssign.yml@workflows-prod
         with:
             PayloadJson: ${{ needs.download-payload.outputs.WorkflowPayload }}
-            AutoAssignUsers: 1
-            AutoLabel: 1
-            ExcludedUserList: '["user1", "user2"]'
-            ExcludedBranchList: '["branch1", "branch2"]'
+            AutoAssignUsers: ${{ fromJSON(needs.config.outputs.AutoAssignUsers) }}
+            AutoAssignReviewers: ${{ fromJSON(needs.config.outputs.AutoAssignReviewers) }}
+            AutoLabel: ${{ fromJSON(needs.config.outputs.AutoLabel) }}
+            ExcludedUserList: ${{ needs.config.outputs.ExcludedUserList }}
+            ExcludedBranchList: ${{ needs.config.outputs.ExcludedBranchList }}
         secrets:
-            AccessToken: ${{ secrets.GITHUB_TOKEN }}
+            AccessToken: ${{ secrets.GITHUB_TOKEN }}
+            PrivateKey: ${{ secrets.M365_APP_PRIVATE_KEY }}
+            ClientId: ${{ secrets.M365_APP_CLIENT_ID }}
+
+

.github/workflows/AutoLabelMsftContributor.yml

@@ -3,23 +3,44 @@ name: (Scheduled) Publish to live
 permissions:
   contents: write
   pull-requests: write
+  checks: read
 
 on:
   schedule:
-    - cron: "25 5,11,17,22 * * *" # Times are UTC based on Daylight Saving Time. Need to be adjusted for Standard Time. Scheduling at :25 to account for queuing lag.
+    - cron: "25 2,5,8,11,14,17,20,22 * * *" # Times are UTC based on Daylight Saving Time (~Mar-Nov). Scheduling at :25 to account for queuing lag.
+    # - cron: "25 3,6,9,12,15,18,21,23 * * *" # Times are UTC based on Standard Time (~Nov-Mar). Scheduling at :25 to account for queuing lag.
 
   workflow_dispatch:
 
 jobs:
 
+  config:
+    if: github.repository_owner == 'MicrosoftDocs' && contains(github.event.repository.topics, 'build')
+    runs-on: ubuntu-latest
+    outputs:
+      EnableAutoPublish: ${{ steps.read.outputs.EnableAutoPublish }}
+      EnableAutoMerge: ${{ steps.read.outputs.EnableAutoMerge }}
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          sparse-checkout: .github/workflow-config.json
+          sparse-checkout-cone-mode: false
+      - id: read
+        shell: pwsh
+        run: |
+          $Config = (Get-Content '.github/workflow-config.json' | ConvertFrom-Json).AutoPublish
+          "EnableAutoPublish=$("$($Config.EnableAutoPublish)".ToLower())" >> $Env:GITHUB_OUTPUT
+          "EnableAutoMerge=$("$($Config.EnableAutoMerge)".ToLower())" >> $Env:GITHUB_OUTPUT
+
   auto-publish:
     if: github.repository_owner == 'MicrosoftDocs' && contains(github.event.repository.topics, 'build')
-    uses: MicrosoftDocs/microsoft-365-docs/.github/workflows/Shared-AutoPublish.yml@workflows-prod
+    needs: config
+    uses: MicrosoftDocs/tcp-workflows/.github/workflows/Shared-AutoPublishV2.yml@workflows-prod
     with:
         PayloadJson: ${{ toJSON(github) }}
-        EnableAutoPublish: true
-
+        EnableAutoPublish: ${{ fromJSON(needs.config.outputs.EnableAutoPublish) }}
+        EnableAutoMerge: ${{ fromJSON(needs.config.outputs.EnableAutoMerge) }}
     secrets:
         AccessToken: ${{ secrets.GITHUB_TOKEN }}
         PrivateKey: ${{ secrets.M365_APP_PRIVATE_KEY }}
-        ClientId: ${{ secrets.M365_APP_CLIENT_ID }}
+        ClientId: ${{ secrets.M365_APP_CLIENT_ID }}

.github/workflows/AutoPublish.yml

@@ -6,6 +6,7 @@ permissions:
 
 on:
   pull_request_target:
+    types: [opened, synchronize, reopened, ready_for_review]
 
 jobs:
   upload:
@@ -21,7 +22,7 @@ jobs:
           mkdir -p ./pr
           echo $PayloadJson > ./pr/PayloadJson.json
           sed -i -e "s/$AccessToken/XYZ/g" ./pr/PayloadJson.json
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v6
         with:
           name: PayloadJson
           path: pr/

.github/workflows/BackgroundTasks.yml

@@ -12,7 +12,7 @@ jobs:
 
   build-status:
     if: github.repository_owner == 'MicrosoftDocs'
-    uses: MicrosoftDocs/microsoft-365-docs/.github/workflows/Shared-BuildValidation.yml@workflows-prod
+    uses: MicrosoftDocs/tcp-workflows/.github/workflows/Shared-BuildValidation.yml@workflows-prod
     with:
       PayloadJson: ${{ toJSON(github) }}
     secrets:

.github/workflows/BuildValidation.yml

@@ -13,7 +13,7 @@ jobs:
 
   live-merge:
     if: github.repository_owner == 'MicrosoftDocs'
-    uses: MicrosoftDocs/microsoft-365-docs/.github/workflows/Shared-LiveMergeCheck.yml@workflows-prod
+    uses: MicrosoftDocs/tcp-workflows/.github/workflows/Shared-LiveMergeCheck.yml@workflows-prod
     with:
       PayloadJson: ${{ toJSON(github) }}
     secrets: