Skip to content

Broken relative links in references/ files of ima-sdk-basics and agent-platform-alert-configuration #205

Description

@ayobamiseun

Several files inside references/ directories link to sibling files using a references/ prefix. Because relative links resolve from the linking file's own directory, these resolve to references/references/…, which doesn't exist — the links 404 on GitHub and point agents at missing files. All link targets exist; only the paths are wrong.

Affected links (file:line → broken target)

  • skills/ads/ima-sdk-basics/references/ima-sdk-tvos-guide.md:6,56references/ima-sdk-ios-guide.md (line 6 is a "Before proceeding, you must read" instruction, so the tvOS guide's primary dependency is unreachable)
  • skills/cloud/agent-platform-alert-configuration/references/cost_alert_policies.md:43,46,55references/no_historical_traffic_data.md, references/has_historical_traffic_data.md
  • skills/cloud/agent-platform-alert-configuration/references/quality_alert_policies.md:70references/telemetry_enablement.md
  • skills/cloud/agent-platform-alert-configuration/references/reliability_alert_policies.md:88,91,100references/no_historical_traffic_data.md, references/has_historical_traffic_data.md

Repro

grep -rnE '\]\(references/' skills/*/*/references/*.md

Suggested fix

Drop the references/ prefix so the links are plain sibling references, e.g. [iOS Guide](ima-sdk-ios-guide.md).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions