Skip to content

docs: fix broken relative links in documentation - #6489

Closed
ankitranjan-dsai wants to merge 1 commit into
google:mainfrom
ankitranjan-dsai:docs/fix-broken-relative-links
Closed

docs: fix broken relative links in documentation#6489
ankitranjan-dsai wants to merge 1 commit into
google:mainfrom
ankitranjan-dsai:docs/fix-broken-relative-links

Conversation

@ankitranjan-dsai

Copy link
Copy Markdown
Contributor

Description

Fixes four broken relative links in the documentation. Each target either does not exist at the referenced path or is malformed, so the link is dead as rendered on GitHub.

  • graph_schema_ddl_advisor.md referenced ddl-reference.md and feature-parity.md; the files in that directory are ddl_reference.md and feature_parity.md (underscores). This file ships inside the package as a BigQuery graph skill reference, so the dead paths affect agents consuming the skill, not just readers on GitHub.
  • contributing/samples/workflows/node_as_tool/README.md pointed at docs/guides/workflows/workflows.md; the guide lives at docs/guides/workflow/workflow/index.md. Sibling sample READMEs (multi_agent/task_sub_agent, managed_agent/*) already use this ../../../../docs/guides/... form correctly.
  • contributing/samples/integrations/jira_agent/README.md had a link target wrapped as (<(https://…)>), which renders the URL as literal text instead of a link.

Documentation only — no source, behaviour, or public API changes.

Testing plan

No unit tests apply, as this changes only markdown link targets. Verified by resolving every relative markdown link in the repository against the filesystem before and after the change:

before: 6 broken relative links
after:  2 broken relative links

The two remaining are intentionally left alone:

  • .agents/skills/adk-sample-creator/SKILL.md:133path/to/guide.md is a placeholder in a template, not a real link.
  • docs/guides/tools/mcp_tool/agent_to_mcp/index.md:139 — points at contributing/samples/mcp/mcp_serve_agent, which does not exist under any name. I did not want to guess which of the 14 samples in contributing/samples/mcp/ was intended; happy to fix it in this PR if a maintainer confirms the right target.

Each changed link was also confirmed to resolve to an existing file.

@adk-bot adk-bot added the documentation [Component] This issue is related to documentation, it will be transferred to adk-docs label Jul 27, 2026
copybara-service Bot pushed a commit that referenced this pull request Jul 27, 2026
Merge #6489

Fixes four broken relative links in the documentation.

PiperOrigin-RevId: 954428272
@adk-bot

adk-bot commented Jul 27, 2026

Copy link
Copy Markdown
Collaborator

Thank you @ankitranjan-dsai for your contribution! 🎉

Your changes have been successfully imported and merged via Copybara in commit 096ecfc.

Closing this PR as the changes are now in the main branch.

@adk-bot adk-bot added the merged [Status] This PR is merged label Jul 27, 2026
@adk-bot adk-bot closed this Jul 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation [Component] This issue is related to documentation, it will be transferred to adk-docs merged [Status] This PR is merged

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants