Skip to content

fix: replace 6 broken Microsoft Learn URLs across 5 solutions#223

Merged
judeper merged 1 commit into
mainfrom
ocean/issue-36
May 25, 2026
Merged

fix: replace 6 broken Microsoft Learn URLs across 5 solutions#223
judeper merged 1 commit into
mainfrom
ocean/issue-36

Conversation

@judeper
Copy link
Copy Markdown
Owner

@judeper judeper commented May 25, 2026

Summary

Initial onboarding review of all 36 solution scaffolds in FSI-AgentGov-Solutions. Validated documentation accuracy, metadata consistency, and cross-references.

Changes

Fixed 6 broken Microsoft Learn URLs (HTTP 404) across 5 solutions:

Solution File Issue
agent-observability-foundation docs/worm-configuration.md SEC 17a-4 page moved
agent-observability-foundation power-bi/README.md ADX connector page moved
conditional-access-automation docs/deployment-guide.md Graph changelog page moved
deny-event-correlation-report docs/prerequisites.md API deprecation page replaced with migration guide
finra-supervision-workflow docs/power-bi-setup.md Dataverse connector page moved
hitl-workflow-governance docs/prerequisites.md, docs/troubleshooting.md Copilot Studio release notes page moved

Validation performed (all passing)

  • 89 unique Microsoft Learn URLs validated — 6 broken, all fixed
  • Version consistency — manifest.yaml matches CHANGELOG.md across all 36 solutions
  • Structural completeness — README.md, CHANGELOG.md, manifest.yaml present in all 36
  • Required manifest fields — name, version, status, domain, controls, description, zones
  • FSI language rules — no prohibited phrases (\�nsures compliance\, \guarantees\, etc.) in non-CHANGELOG files
  • Product naming — no legacy \Azure Active Directory\ references; \Azure AD\ only in historical CHANGELOG entries
  • Role naming — \Global Administrator\/\Compliance Administrator\ references are in technical contexts (Entra role assignments, conflict detection rules with GUIDs) where official role names are correct
  • Manifest build — \python scripts/build-manifest.py --check\ passes

Resolves judeper/OceanSquad#36

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>
@judeper judeper merged commit c98f4e6 into main May 25, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant