From b745d78333a731d9e992ccf6ff42d65785814c48 Mon Sep 17 00:00:00 2001 From: judeper Date: Mon, 25 May 2026 15:18:47 -0400 Subject: [PATCH] fix: replace 6 broken Microsoft Learn URLs across 5 solutions Validated all 89 unique Microsoft Learn URLs across 36 solution directories. Found and fixed 6 returning HTTP 404: - agent-observability-foundation: SEC 17a-4 compliance page moved to /compliance/regulatory/offering-SEC-docs - agent-observability-foundation: Power BI ADX connector moved to /azure/data-explorer/power-bi-data-connector - conditional-access-automation: Graph changelog moved to /graph/whats-new-overview - deny-event-correlation-report: Azure Monitor API deprecation page replaced with migration guide at /logs/api/migrate-batch-and-beta - finra-supervision-workflow: Dataverse connector moved to /power-query/connectors/dataverse - hitl-workflow-governance (2 files): Copilot Studio release-notes moved to /microsoft-copilot-studio/whats-new Additional validation performed (all passed): - Version consistency: manifest.yaml vs CHANGELOG.md across all 36 - Structural completeness: README.md, CHANGELOG.md, manifest.yaml present - Required manifest fields: name, version, status, domain, controls, description, zones - FSI language rules: no prohibited phrases in non-CHANGELOG files - Product naming: no legacy Azure Active Directory references - Manifest build check: build-manifest.py --check passes Closes judeper/OceanSquad#36 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- agent-observability-foundation/docs/worm-configuration.md | 2 +- agent-observability-foundation/power-bi/README.md | 2 +- conditional-access-automation/docs/deployment-guide.md | 2 +- deny-event-correlation-report/docs/prerequisites.md | 2 +- finra-supervision-workflow/docs/power-bi-setup.md | 2 +- hitl-workflow-governance/docs/prerequisites.md | 2 +- hitl-workflow-governance/docs/troubleshooting.md | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/agent-observability-foundation/docs/worm-configuration.md b/agent-observability-foundation/docs/worm-configuration.md index 21987c27..5f10f48f 100644 --- a/agent-observability-foundation/docs/worm-configuration.md +++ b/agent-observability-foundation/docs/worm-configuration.md @@ -272,7 +272,7 @@ Locked WORM storage has cost implications: - [verify_worm.py](https://github.com/judeper/FSI-AgentGov-Solutions/blob/main/agent-observability-foundation/scripts/verify_worm.py) - Verification script (read-only) - [Azure Immutable Storage Overview](https://learn.microsoft.com/azure/storage/blobs/immutable-storage-overview) -- [SEC 17a-4 Compliance Assessment](https://learn.microsoft.com/azure/compliance/offerings/offering-sec-17a-4) +- [SEC 17a-4 Compliance Assessment](https://learn.microsoft.com/en-us/compliance/regulatory/offering-SEC-docs) - [Cohasset Compliance Assessment](https://servicetrust.microsoft.com) --- diff --git a/agent-observability-foundation/power-bi/README.md b/agent-observability-foundation/power-bi/README.md index 0cc20e97..8110e0dc 100644 --- a/agent-observability-foundation/power-bi/README.md +++ b/agent-observability-foundation/power-bi/README.md @@ -221,7 +221,7 @@ The Power BI solution connects to Application Insights telemetry via Azure Data ### Microsoft Learn Resources - **[Power BI DirectQuery](https://learn.microsoft.com/power-bi/connect-data/desktop-directquery-about)** - DirectQuery concepts and limitations -- **[Azure Data Explorer Connector](https://learn.microsoft.com/power-bi/connect-data/desktop-connect-azure-data-explorer)** - ADX connector documentation +- **[Azure Data Explorer Connector](https://learn.microsoft.com/en-us/azure/data-explorer/power-bi-data-connector)** - ADX connector documentation - **[Log Analytics Workspace](https://learn.microsoft.com/azure/azure-monitor/logs/log-analytics-workspace-overview)** - Workspace concepts and query optimization --- diff --git a/conditional-access-automation/docs/deployment-guide.md b/conditional-access-automation/docs/deployment-guide.md index 49f70f0e..b589b250 100644 --- a/conditional-access-automation/docs/deployment-guide.md +++ b/conditional-access-automation/docs/deployment-guide.md @@ -250,7 +250,7 @@ Allow 24-48 hours for report-only data collection. > is part of the Microsoft Graph beta surface and is subject to change without > notice. Do not depend on its response shape in production runbooks; treat > it as an interactive validation aid only. Track changes in the -> [Microsoft Graph beta changelog](https://learn.microsoft.com/graph/changelog). +> [Microsoft Graph changelog](https://learn.microsoft.com/en-us/graph/whats-new-overview). ```powershell # Test Zone 3 user accessing Copilot Studio diff --git a/deny-event-correlation-report/docs/prerequisites.md b/deny-event-correlation-report/docs/prerequisites.md index 4c0f3052..8e2bae16 100644 --- a/deny-event-correlation-report/docs/prerequisites.md +++ b/deny-event-correlation-report/docs/prerequisites.md @@ -242,7 +242,7 @@ union isfuzzy=true ### Reference -- [Azure Monitor deprecation announcement](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/api/deprecation) +- [Azure Monitor API migration guide](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/api/migrate-batch-and-beta) - [Entra ID authentication for Azure Monitor](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/api/access-api) --- diff --git a/finra-supervision-workflow/docs/power-bi-setup.md b/finra-supervision-workflow/docs/power-bi-setup.md index 01b803f5..0a7122c0 100644 --- a/finra-supervision-workflow/docs/power-bi-setup.md +++ b/finra-supervision-workflow/docs/power-bi-setup.md @@ -303,5 +303,5 @@ For regulatory examinations, export compliance evidence: ## Related Resources - [Power BI Documentation](https://learn.microsoft.com/en-us/power-bi/) -- [Dataverse Connector](https://learn.microsoft.com/en-us/power-bi/connect-data/service-connect-to-dataverse) +- [Dataverse Connector](https://learn.microsoft.com/en-us/power-query/connectors/dataverse) - [Control 3.3: Compliance Reporting](https://github.com/judeper/FSI-AgentGov/blob/main/docs/controls/pillar-3-reporting/3.3-compliance-and-regulatory-reporting.md) diff --git a/hitl-workflow-governance/docs/prerequisites.md b/hitl-workflow-governance/docs/prerequisites.md index a8eff476..b23c7f85 100644 --- a/hitl-workflow-governance/docs/prerequisites.md +++ b/hitl-workflow-governance/docs/prerequisites.md @@ -2,7 +2,7 @@ Requirements for deploying the HITL Workflow Governance solution. -> **Preview Notice:** The Human in the Loop connector actions — **Request for Information** (RFI) and **Run a Multistage Approval** — are currently in public preview. RFI entered public preview in July 2025. The connector reference labels both actions as "(preview)." Preview features may change before general availability. This solution provides governance tooling, but administrators should monitor the [Copilot Studio release notes](https://learn.microsoft.com/en-us/microsoft-copilot-studio/release-notes) and connector reference for changes that may affect behavior. +> **Preview Notice:** The Human in the Loop connector actions — **Request for Information** (RFI) and **Run a Multistage Approval** — are currently in public preview. RFI entered public preview in July 2025. The connector reference labels both actions as "(preview)." Preview features may change before general availability. This solution provides governance tooling, but administrators should monitor the [Copilot Studio release notes](https://learn.microsoft.com/en-us/microsoft-copilot-studio/whats-new) and connector reference for changes that may affect behavior. --- diff --git a/hitl-workflow-governance/docs/troubleshooting.md b/hitl-workflow-governance/docs/troubleshooting.md index c0402d53..be240330 100644 --- a/hitl-workflow-governance/docs/troubleshooting.md +++ b/hitl-workflow-governance/docs/troubleshooting.md @@ -116,7 +116,7 @@ Error: Access denied to table fsi_HitlCheckpointResult **Cause:** The **Request for Information** action entered public preview in July 2025. The `advancedapprovals` connector schema may change before general availability. Microsoft may update action parameter names, add new required fields, or modify the bot component representation. **Resolution:** -1. Check the [Copilot Studio release notes](https://learn.microsoft.com/en-us/microsoft-copilot-studio/release-notes) for recent connector changes +1. Check the [Copilot Studio release notes](https://learn.microsoft.com/en-us/microsoft-copilot-studio/whats-new) for recent connector changes 2. Compare current `botcomponent` content against the expected patterns in `Test-HitlWorkflowCompliance.ps1` 3. If the connector schema has changed: - Update the scan script's action detection patterns to match the new schema