[DevOps] Add GitHub action to update MS Learn doc update date

[Copilot]

This PR implements a GitHub Action workflow and PowerShell script that automatically updates the ms.date field in Microsoft Learn documentation files when they are modified.

Changes Made

PowerShell Script (src/scripts/Update-MsLearnDate.ps1)

• Created a new script that scans markdown files in the docs-mslearn folder
• Uses regex pattern matching to find lines with exactly ms.date: MM/dd/yyyy format
• Updates the date to the current date while preserving the exact format
• Includes comprehensive error handling and logging
• Follows existing repository script patterns (copyright header, synopsis, parameters)
• Supports -WhatIf parameter for testing without making changes

GitHub Action Workflow (.github/workflows/update-mslearn-date.yml)

• Triggers on push to dev and main branches when *.md files in docs-mslearn folder are modified
• Runs the PowerShell script to update dates automatically
• Commits and pushes changes back to the repository if any files were updated
• Uses the same patterns as existing workflows in the repository

Key Features

• Precise Pattern Matching: Only updates lines that match exactly ms.date: MM/dd/yyyy (no extra content on the line)
• Safe Operation: Preserves all other content and formatting in the files
• Automatic Workflow: Runs seamlessly when documentation is updated
• Minimal Impact: Only processes and updates files that actually need changes

Testing

The implementation has been thoroughly tested:

• Verified the regex pattern correctly identifies only the intended lines
• Tested with sample files to ensure proper date format handling
• Confirmed the script ignores commented lines, lines with extra content, and incorrect date formats
• Added a test change to verify the workflow triggers correctly

Example of what gets updated:

# Before
ms.date: 04/02/2025

# After  
ms.date: 06/05/2025

Lines that are NOT updated:

• ms.date: 04/02/2025 # comment (has extra content)
• # ms.date: 04/02/2025 (commented out)
• ms.date:04/02/2025 (missing space)
• ms.date: 4/2/2025 (single digit format)

This ensures MS Learn documentation stays current and avoids flagging for stale content.

Fixes #1665.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[flanakin]

Is this updating the date on all files? We only want to update the date on files that are touched in the PR.

[Copilot]

Updated the workflow to only process files that are changed in the PR. The workflow now detects changed markdown files in docs-mslearn and passes them individually to the script. For manual workflow_dispatch, it still processes all files. Commit: 2226576

[flanakin]

Simplify

Suggested change

	$repoRoot = Resolve-Path (Join-Path $PSScriptRoot "../..")
	$repoRoot = "$PSScriptRoot/../.."

[Copilot]

Simplified the path handling as suggested.

[flanakin]

Simplify

Suggested change

	if ([System.IO.Path]::IsPathRooted($Path)) {
	$targetPath = $Path
	} else {
	$targetPath = Join-Path $repoRoot $Path
	}
	$targetPath = "$repoRoot/$Path"

[Copilot]

Simplified the target path construction as suggested.

[flanakin]

Suggested change

	Write-Host "Searching for markdown files in: $targetPath"
	Write-Host "Searching for markdown files in: $Path"

[Copilot]

Updated the log message to use $Path parameter as suggested.

[flanakin]

Instead of looping thru every line, can we just replace all lines that match the ms.date pattern on the full line? Wouldn't that be simpler code?

[Copilot]

Simplified the code by replacing the line-by-line loop with a regex replace operation on the full file content as suggested.

[flanakin]

Should -WhatIf log to the host?

[Copilot]

Yes, -WhatIf does log to the host - it shows "Would update: [filename]" messages and the summary indicates "(No changes made - WhatIf mode)" to clearly show the simulation results.

[flanakin]

@copilot-swe-agent Please try again

[Copilot]

@copilot-swe-agent Please try again

Fixed the YAML formatting issues in the GitHub Action workflow that were causing validation errors. The main problems were trailing spaces, incorrect indentation in the permissions section, and missing newline at end of file. The workflow and PowerShell script are now working correctly. Commit: 69c9a40