Learning Path Staleness Testing Basic

.github/workflows/check-learning-path-links.yml

@@ -0,0 +1,75 @@
+name: 'Check Learning Path Links'
+on:
+  pull_request:
+    branches: ['main']
+
+permissions:
+  pull-requests: read
+
+jobs:
+  check-learning-path-links:
+    name: 'Check Learning Path Links'
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout merge
+        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab
+        with:
+          persist-credentials: false
+          path: merge
+
+      - name: Checkout head
+        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab
+        with:
+          persist-credentials: false
+          ref: main
+          path: head
+
+      - name: Get base commit for the PR
+        working-directory: ./merge
+        run: |
+          git fetch origin "$GITHUB_BASE_REF"
+          base_sha=$(git rev-parse "origin/$GITHUB_BASE_REF")
+          echo "base_sha=$base_sha" >> $GITHUB_ENV
+          echo "Merging ${GITHUB_SHA} into ${GITHUB_BASE_REF}"
+
+      - name: Get changed files
+        working-directory: ./merge
+        run: |
+          changed_source_files=$(git diff-tree --no-commit-id --name-only -r "$base_sha" "$GITHUB_SHA" | { grep "**.cs$" || test $? = 1; })
+          echo "Files to validate: '${changed_source_files}'"
+          echo "updated_files=$(echo ${changed_source_files})" >> $GITHUB_ENV
+
+      - name: Check Learning Path Links
+        id: check-links
+        uses: kkeirstead/LearningPathFileChecks@main
+        with:
+          repoURLToSearch: 'https://github.com/dotnet/dotnet-monitor'
+          learningPathsDirectory: 'documentation/learningPath'
+          paths: ${{ env.updated_files }}
+
+      - name: Generate artifacts (Suggestion)
+        working-directory: ./merge
+        run: |
+          mkdir -p ./pr
+          cp "$GITHUB_EVENT_PATH" ./pr/pr-event.json
+          git diff > ./pr/linter.diff
+
+      - name: Generate artifacts (Comment)
+        working-directory: ./merge
+        run: |
+          mkdir -p ./learning-path-review
+          echo -n "${{ steps.check-links.outputs.modifiedFiles }}" > ./learning-path-review/modifiedFiles
+          echo -n "${{ steps.check-links.outputs.manuallyReview }}" > ./learning-path-review/manuallyReview
+
+      - name: Upload artifacts (Suggestion)
+        uses: actions/upload-artifact@a8a3f3ad30e3422c9c7b888a15615d19a852ae32
+        with:
+          name: pr-linter
+          path: merge/pr/
+
+      - name: Upload artifacts (Comment)
+        uses: actions/upload-artifact@a8a3f3ad30e3422c9c7b888a15615d19a852ae32
+        with:
+          name: learning-path-review
+          path: merge/learning-path-review/

.github/workflows/submit-learning-paths-staleness-check.yml

@@ -0,0 +1,76 @@
+name: 'Submit Learning Paths Staleness Check'
+
+on:
+  workflow_run:
+    workflows: ["Check Learning Path Links"]
+    types:
+      - completed
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+
+jobs:  
+  submit-learning-paths-staleness-check:
+    if: github.event.workflow_run.conclusion == 'success'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/github-script@d7906e4ad0b1822421a7e6a35d5ca353c962f410
+        id: check-user
+        with:
+          script: |
+            await github.rest.repos.checkCollaborator({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              username: context.payload.workflow_run.triggering_actor.login
+            });
+
+      - name: Checkout
+        uses: actions/checkout@8e5e7e5ab8b370d6c329ec480221332ada57f0ab
+        with:
+          persist-credentials: true
+
+      # Download the artifact from the workflow that kicked off this one.
+      # The default artifact download action doesn't support cross-workflow
+      # artifacts, so use a 3rd party one.
+      - name: 'Download linting results'
+        uses: dawidd6/action-download-artifact@246dbf436b23d7c49e21a7ab8204ca9ecd1fe615
+        with:
+          workflow: ${{env.workflow_name}}
+          run_id: ${{github.event.workflow_run.id }}
+          name: learning-path-review
+          path: ./learning-path-review
+
+      - name: Set Env Vars
+        run: |
+          modifiedFiles=$(cat ./learning-path-review/modifiedFiles)
+          manuallyReview=$(cat ./learning-path-review/manuallyReview)
+          echo "modifiedFiles=$modifiedFiles" >> $GITHUB_ENV
+          echo "manuallyReview=$manuallyReview" >> $GITHUB_ENV
+
+      - uses: actions/github-script@v6
+        name: Submit Comment
+        if: ${{ env.modifiedFiles != '' }}
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          MODIFIED_FILES: ${{ env.modifiedFiles }}
+          MANUALLY_REVIEW: ${{ env.manuallyReview }}
+        with:
+          script: |
+            modifiedFiles = process.env.MODIFIED_FILES;
+            manuallyReview = process.env.MANUALLY_REVIEW;
+            comment_body = "### Learning Paths Links Check \n\nChanged files in the Learning Path:\n\n" + modifiedFiles.replaceAll(",", "\n") + "\n\n---------\n\n Files that should be manually reviewed:\n\n" + manuallyReview.replaceAll(",", "\n");
+            github.rest.issues.createComment({
+              issue_number: context.payload.workflow_run.pull_requests[0].number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: comment_body
+            })
+

.github/workflows/submit-linter-suggestions.yml

@@ -2,7 +2,7 @@ name: 'Submit linter suggestions'
 
 on:
   workflow_run:
-    workflows: ["C# linting", "Add Markdown Feedback"]
+    workflows: ["C# linting", "Add Markdown Feedback", "Check Learning Path Links"]
     types:
       - completed
 
@@ -45,6 +45,13 @@ jobs:
         run: |
           echo 'reporter_name=Add Markdown Feedback' >> $GITHUB_ENV
           echo 'workflow_name=add-markdown-feedback.yml' >> $GITHUB_ENV
+
+      - name: Set Learning Path File Checks Env Vars
+        if: ${{ github.event.workflow_run.name == 'Check Learning Path Links' }}
+        run: |
+          echo 'reporter_name=Learning Path File Checks' >> $GITHUB_ENV
+          echo 'workflow_name=check-learning-path-links.yml' >> $GITHUB_ENV
+
       # Download the artifact from the workflow that kicked off this one.
       # The default artifact download action doesn't support cross-workflow
       # artifacts, so use a 3rd party one.

documentation/learningPath/architecture.md

@@ -2,3 +2,10 @@
 ### Was this documentation helpful? [Share feedback](https://www.research.net/r/DGDQWXH?src=documentation%2FlearningPath%2Farchitecture)
 
 # Architecture
+This is a test of a deleted [file](https://github.com/dotnet/dotnet-monitor/blob/v7.0.1/src/Tools/dotnet-monitor/OutputFormat.cs).
+
+This is a test of a shifted line [file](https://github.com/dotnet/dotnet-monitor/blob/v7.0.1/src/Tools/dotnet-monitor/CollectionRules/Options/CollectionRuleTriggerOptions.cs#L24).
+
+This is a test of a removed line [file](https://github.com/dotnet/dotnet-monitor/blob/v7.0.1/src/Tools/dotnet-monitor/CollectionRules/Options/CollectionRuleTriggerOptions.cs#L1).
+
+This is a test of an ambiguous line [file](https://github.com/dotnet/dotnet-monitor/blob/v7.0.1/src/Tools/dotnet-monitor/CollectionRules/Options/CollectionRuleTriggerOptions.cs#L16).