Fix broken external links in docs#320
Conversation
- Update GitHub LICENSE links from master to main branch (10 files) - Drop incorrect /warp prefix from docs.warp.dev self-links - Point CLI agents link to cli-agents/overview landing page Co-Authored-By: Oz <oz-agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
There was a problem hiding this comment.
This PR correctly fixes 13 broken external links: 10 GitHub LICENSE links updated from master to main, two docs.warp.dev self-links with an incorrect /warp prefix removed, and one CLI agents link corrected to point at /agent-platform/cli-agents/overview. The internal link checker confirms 0 broken internal links after the fix, and all corrected destination paths exist in the docs structure. However, contributing.md has four additional GitHub links still pointing to the master branch that were missed — the CONTRIBUTING.md link on the same changed line (line 10), plus CONTRIBUTING.md and CODE_OF_CONDUCT.md links on lines 15, 40, and 44. Found: 1 critical, 0 important, 0 suggestions, 0 nits. Request changes.
There was a problem hiding this comment.
🚨 [CRITICAL] The LICENSE link on this line was correctly updated to main, but the CONTRIBUTING.md link at the end of the same line still points to master and is likely also 404.
The same file has three more missed master links outside this diff hunk:
- Line 15:
[`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md) - Line 40:
[`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md#reporting-security-issues) - Line 44:
[full text](https://github.com/warpdotdev/warp/blob/master/CODE_OF_CONDUCT.md)
All four should use main instead of master. Fixing line 10 here:
Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/main/LICENSE) at [`warpdotdev/warp`](https://github.com/warpdotdev/warp), and there's room for every kind of contribution — from a one-line bug report to a full feature PR, a new theme, or a workflow that ships to every Warp user. For the full code contribution flow, see [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/main/CONTRIBUTING.md).
| # Contributing to Warp | ||
|
|
||
| Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/master/LICENSE) at [`warpdotdev/warp`](https://github.com/warpdotdev/warp), and there's room for every kind of contribution — from a one-line bug report to a full feature PR, a new theme, or a workflow that ships to every Warp user. For the full code contribution flow, see [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md). | ||
| Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/main/LICENSE) at [`warpdotdev/warp`](https://github.com/warpdotdev/warp), and there's room for every kind of contribution — from a one-line bug report to a full feature PR, a new theme, or a workflow that ships to every Warp user. For the full code contribution flow, see [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md). |
There was a problem hiding this comment.
🚨 [CRITICAL] The LICENSE link on this line was correctly updated to main, but the CONTRIBUTING.md link at the end of the same line still points to master and is likely also 404.
The same file has three more missed master links outside this diff hunk:
- Line 15:
[`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md) - Line 40:
[`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md#reporting-security-issues) - Line 44:
[full text](https://github.com/warpdotdev/warp/blob/master/CODE_OF_CONDUCT.md)
All four should use main instead of master. Fixing line 10 here:
| Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/main/LICENSE) at [`warpdotdev/warp`](https://github.com/warpdotdev/warp), and there's room for every kind of contribution — from a one-line bug report to a full feature PR, a new theme, or a workflow that ships to every Warp user. For the full code contribution flow, see [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md). | |
| Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/main/LICENSE) at [`warpdotdev/warp`](https://github.com/warpdotdev/warp), and there's room for every kind of contribution — from a one-line bug report to a full feature PR, a new theme, or a workflow that ships to every Warp user. For the full code contribution flow, see [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/main/CONTRIBUTING.md). |
There was a problem hiding this comment.
This PR correctly fixes 13 broken external links: 10 GitHub LICENSE links updated from master to main, two docs.warp.dev self-links with an incorrect /warp prefix removed, and one CLI agents link corrected to point at /agent-platform/cli-agents/overview. The internal link checker confirms 0 broken internal links after the fix, and all corrected destination paths exist in the docs structure. However, contributing.md has four additional GitHub links still pointing to the master branch that were missed — the CONTRIBUTING.md link on the same changed line (line 10), plus CONTRIBUTING.md and CODE_OF_CONDUCT.md links on lines 15, 40, and 44. Found: 1 critical, 0 important, 0 suggestions, 0 nits. Request changes.
| # Contributing to Warp | ||
|
|
||
| Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/master/LICENSE) at [`warpdotdev/warp`](https://github.com/warpdotdev/warp), and there's room for every kind of contribution — from a one-line bug report to a full feature PR, a new theme, or a workflow that ships to every Warp user. For the full code contribution flow, see [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md). | ||
| Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/main/LICENSE) at [`warpdotdev/warp`](https://github.com/warpdotdev/warp), and there's room for every kind of contribution — from a one-line bug report to a full feature PR, a new theme, or a workflow that ships to every Warp user. For the full code contribution flow, see [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md). |
There was a problem hiding this comment.
🚨 [CRITICAL] The LICENSE link on this line was correctly updated to main, but the CONTRIBUTING.md link at the end of the same line still points to master and is likely also 404.
The same file has three more missed master links outside this diff hunk:
- Line 15:
[`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md) - Line 40:
[`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md#reporting-security-issues) - Line 44:
[full text](https://github.com/warpdotdev/warp/blob/master/CODE_OF_CONDUCT.md)
All four should use main instead of master. Fixing line 10 here:
| Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/main/LICENSE) at [`warpdotdev/warp`](https://github.com/warpdotdev/warp), and there's room for every kind of contribution — from a one-line bug report to a full feature PR, a new theme, or a workflow that ships to every Warp user. For the full code contribution flow, see [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md). | |
| Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/main/LICENSE) at [`warpdotdev/warp`](https://github.com/warpdotdev/warp), and there's room for every kind of contribution — from a one-line bug report to a full feature PR, a new theme, or a workflow that ships to every Warp user. For the full code contribution flow, see [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/main/CONTRIBUTING.md). |
1 participant
Summary
Fixes broken external links found by the
check_for_broken_linksskill scan of the docs source.The internal link check passed with 0 broken links (1743 checked). The external scan surfaced 15 broken links; 13 were real and are fixed here, and 2 are false positives (bot-blocked but valid for humans, verified with a browser user-agent).
Fixes
github.com/warpdotdev/warp/blob/master/LICENSEreturned 404 because the branch is nowmain. Updatedmaster→main.docs.warp.devself-links with an incorrect/warpprefix (thewarp/folder is the docs homepage, so it is not part of the URL):agent-platform/warp-agents/codebase-context.md:/warp/code/code-editor→/code/code-editor(and the neighboring File Tree link for consistency)agent-platform/warp-agents/slash-commands.md:/warp/terminal/settings→/terminal/settingswarp/getting-started/migrate-to-warp/migrate-to-warp-from-claude-code.md:/agent-platform/cli-agents(no landing page, 404) →/agent-platform/cli-agents/overview.Not changed (verified false positives)
https://help.openai.com/en/articles/4936856-understanding-tokens— HTTP 403 (Cloudflare bot protection; valid for humans).https://www.tiktok.com/@warp.dev— HTTP 403 to bots; returns 200 with a browser user-agent.Verification
Re-ran the external link check after fixes: only the 2 known false positives remain.
Conversation: https://app.warp.dev/conversation/fa5c6325-724a-40c8-ac35-5652c76fbf21
Run: https://oz.warp.dev/runs/019f4b41-647f-75c6-8a52-baabba614637
This PR was generated with Oz.