fix(link): resolve broken link checker failure in index.qmd

[Copilot]

Remediation PR -- Metadata

Target file: index.qmd
Issue: Link checker CI failure (job 70984663005)
Type: broken-link

Summary

• Change: Update markdown link on line 11 from docs/index.html → docs/index.qmd
• UIAO ID: N/A
• Owner: N/A
• Status: Fix

Changes

• Update link target in index.qmd line 11:

-Redirecting to [UIAO Modernization Atlas](docs/index.html)...
+Redirecting to [UIAO Modernization Atlas](docs/index.qmd)...

The <meta http-equiv="refresh"> on line 8 retains docs/index.html — that is a runtime browser redirect to the built output and is not evaluated by the link checker. The markdown link on line 11 is what the link checker validates against source files; docs/index.qmd exists in the repository, docs/index.html does not.

Rationale

Link checker validates source-level references, not build artifacts. docs/index.html is generated at build time and absent from the source tree, causing CI to fail. docs/index.qmd is the canonical source file and resolves correctly.

Branch naming

copilot/fix-broken-link-index-qmd

Commit message format

[UIAO-DOCS] FIX: index.qmd — update broken link from docs/index.html to docs/index.qmd

Checklist

• Used canonical UIAO frontmatter template
• uiao.id follows UIAO_<AppendixLetter>_<Number>
• uiao.status is one of: Current, Draft, Needs Replacing, Needs Creating, Deprecated
• uiao.owner is a team or role
• uiao.tags present and relevant
• Status badge present in top 8 lines
• Diagrams include title and desc if applicable
• Local validation passed: node scripts/validate_uiao_metadata.js
• CI validation passes

Reviewer guidance

• Confirm docs/index.qmd is the correct redirect target
• No frontmatter or metadata contract changes; scope is a single link fix
• Meta refresh tag intentionally left unchanged — it targets the built HTML output at runtime

Post-merge actions

• Verify link checker CI passes on merge
• Confirm docs/_data/corpus-index.json updated
• Confirm governance dashboard reflects the change
• Close linked issue when remediation is verified

Original prompt

The link checker is failing because index.qmd contains a broken link reference [UIAO Modernization Atlas](docs/index.html) that doesn't resolve to an actual file in the repository structure.

Current Issue:

• File: /index.qmd line 11
• Broken link: docs/index.html
• Error: The link checker cannot find the target file

Root Cause:
The markdown link points to docs/index.html but this file is generated at build time from docs/index.qmd. The link checker validates against the source repository structure and expects either:

1. An actual .html file to exist, or
2. A reference to the source .qmd file

Solution:
Change the link from docs/index.html to docs/index.qmd to reference the actual source file that the link checker can validate.

The following is the prior conversation context from the user's chat exploration (may be truncated):

User: Please find a solution for failing job 70984663005. Use the logs, job definition, and any referenced files where the failure occurred. Keep your response focused on the solution and include code suggestions when appropriate.

Assistant: I'll help you find a solution for the failing job. Let me start by retrieving the logs for that job.

Assistant: The job failed because of a broken internal link. Let me get the file with the broken link to understand the issue better.

Assistant: ## Solution for Job 70984663005

Problem: The link checker found a broken internal link in index.qmd pointing to docs/index.html, but the file structure doesn't match this reference.

Root Cause: The index.qmd file at the repository root (line 11) references docs/index.html as a redirect target, but based on the file structure, the actual content is in docs/index.qmd or site/index.qmd. The link checker expects the target to exist as a valid file reference.

Solution: Update the broken link in /index.qmd to point to the correct location:

---
title: "UIAO Modernization Atlas"
format:
  html:
    page-layout: custom
    include-in-header:
      - text: |
          <meta http-equiv="refresh" content="0; url=docs/index.html" />
---

Redirecting to [UIAO Modernization Atlas](../docs/index.html)...

Alternative approach (if docs/index.html doesn't render as expected): If the build process doesn't generate docs/index.html from docs/index.qmd, update the redirect to use the source file:

Redirecting to [UIAO Modernization Atlas](docs/index.qmd)...

Or ensure the meta refresh tag matches the link text:

<meta http-equiv="refresh" content="0; url=docs/" />

The link checker will pass once the markdown link target resolves to an actual file in the repository structure.

User: fix please

Assistant: Now I'll create a pull request to fix the broken link:

Assistant: I'm waiting for your approval to proceed with creating a pull request to fix the broken link. The tool will update index.qmd line 11 to change docs/index.html to docs/index.qmd so the link checker can validate the target file exists in the repository.

This pull request was created from Copilot chat.