From bf7864ad781391524db6126f41a8e147b7830cb8 Mon Sep 17 00:00:00 2001
From: Wes Haggard <weshaggard@users.noreply.github.com>
Date: Wed, 12 Nov 2025 09:50:14 -0800
Subject: [PATCH] Adjust link checking for copilot instructions

Disable link checking guidelines for copilot instruction files.
---
 eng/common/scripts/Verify-Links.ps1 | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/eng/common/scripts/Verify-Links.ps1 b/eng/common/scripts/Verify-Links.ps1
index d4406c609d0e..fe04a9b1db2a 100644
--- a/eng/common/scripts/Verify-Links.ps1
+++ b/eng/common/scripts/Verify-Links.ps1
@@ -530,6 +530,8 @@ foreach ($url in $urls) {
 
 LogGroupStart "Link checking details"
 
+$originalcheckLinkGuidance = $checkLinkGuidance
+
 while ($pageUrisToCheck.Count -ne 0)
 {
   $pageUri = $pageUrisToCheck.Dequeue();
@@ -538,6 +540,11 @@ while ($pageUrisToCheck.Count -ne 0)
     if ($checkedPages.ContainsKey($pageUri)) { continue }
     $checkedPages[$pageUri] = $true;
 
+    # copilot instructions require the use of relative links which is against our general guidance
+    # but we mainly care about those guidelines for docs publishing and not copilot instructions
+    # so we can disable the guidelines while validating copilot instruction files.
+    if ($pageUri -match "instructions.md$") { $checkLinkGuidance = $false }
+
     [string[]] $linkUris = GetLinks $pageUri
     Write-Host "Checking $($linkUris.Count) links found on page $pageUri";
     $badLinksPerPage = @();
@@ -561,6 +568,8 @@ while ($pageUrisToCheck.Count -ne 0)
   } catch {
     Write-Host "Exception encountered while processing pageUri $pageUri : $($_.Exception)"
     throw
+  } finally {
+    $checkLinkGuidance = $originalcheckLinkGuidance
   }
 }