Create orphaned-includes.yml

Author: gewarren

.github/workflows/orphaned-includes.yml

@@ -0,0 +1,43 @@
+name: "clean repo - includes"
+
+on:
+  schedule:
+    - cron: "0 1 1 * *" # Runs at 01:00, on day 1 of the month
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  clean-repo:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Harden Runner
+        uses: step-security/harden-runner@91182cccc01eb5e619899d80e4e971d6181294a7 # v2.10.1
+        with:
+          egress-policy: audit
+
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      # Call clean repo
+      - name: Clean repo
+        id: clean-repo-step
+        uses: dotnet/docs-tools/cleanrepo@1c13adc87741beab84bb6e286d17b3b95ce687d8
+        with:
+          function: 'FindOrphanedIncludes'
+          docfx_directory: '.'
+          target_directory: 'docs'
+          url_base_path: '/dotnet'
+        
+      # Create the PR for the work done by the "clean repo" tool
+      - name: create-pull-request
+        uses: peter-evans/create-pull-request@5e914681df9dc83aa4e4905692ca88beb2f9e91f
+        with:
+          branch: create-cleanrepo-pull-request/patch
+          title: "Monthly chores: Delete orphaned include files"
+          commit-message: 'Bot 🤖 generated CleanRepo tool run'
+          body: "Find and delete orphaned include files. Contributes to #..."