fix: [AI-7362] canonicalize legacy URLs (sh, my, dm hosts)#1004
Conversation
- docs.altimate.sh/* -> https://help.altimate.ai/code/* - datamates-docs.myaltimate.com/* -> https://help.altimate.ai/datamates/* - www.altimate.sh/benchmarks -> https://altimate.ai/benchmarks/ Installer paths (altimate.sh/install, install.ps1) untouched. docs.altimate.ai refs deferred pending slug map from MAR-268 (1 ref in CHANGELOG.md). docs/docs/CNAME and docs/mkdocs.yml left unchanged (site self-config). script/upstream/ excluded (intentional branding/redirect map).
|
Thanks for your contribution! This PR doesn't have a linked issue. All PRs must reference an existing issue. Please:
See CONTRIBUTING.md for details. |
![claude[bot]](https://avatars.githubusercontent.com/in/1236702?s=60&v=4){kind=small}
There was a problem hiding this comment.
Claude Code Review
This repository is configured for manual code reviews. Comment @claude review for a one-time review, or @claude review always to subscribe this PR to a review on every future push.
Tip: disable this comment in your organization's Code Review settings.
|
|
||
| // altimate_change start — altimate docs URL | ||
| When the user directly asks about Altimate Code (eg. "can Altimate Code do...", "does Altimate Code have..."), or asks in second person (eg. "are you able...", "can you do..."), or asks how to use a specific Altimate Code feature (eg. implement a hook, write a slash command, or install an MCP server), use the WebFetch tool to gather information to answer the question from Altimate Code docs. The list of available docs is available at https://docs.altimate.sh | ||
| When the user directly asks about Altimate Code (eg. "can Altimate Code do...", "does Altimate Code have..."), or asks in second person (eg. "are you able...", "can you do..."), or asks how to use a specific Altimate Code feature (eg. implement a hook, write a slash command, or install an MCP server), use the WebFetch tool to gather information to answer the question from Altimate Code docs. The list of available docs is available at https://help.altimate.ai/code |
There was a problem hiding this comment.
Consider aligning the sibling prompt variants in this same pass: packages/opencode/src/session/prompt/default.txt:9 and qwen.txt:11 still instruct models to WebFetch Altimate docs from the bare marketing host https://altimate.ai (no docs index), while this file now correctly points at https://help.altimate.ai/code.
qwen.txt is a live prompt — imported as PROMPT_ANTHROPIC_WITHOUT_TODO in session/system.ts — so non-Anthropic models get a worse "ask about Altimate Code" experience than Anthropic ones after this change.
This is pre-existing (both files used altimate.ai before) and bare altimate.ai wasn't in the declared swap list, so it's a follow-up rather than a blocker. Pointing both at https://help.altimate.ai/code, plus a small test asserting all docs-instruction prompts agree, would close the gap.
There was a problem hiding this comment.
Fixed in commit 3ed3f47 — default.txt:9 and qwen.txt:11 now both reference https://help.altimate.ai/code to match anthropic.txt. The change was surgical (one line each), leaving all other content in the files untouched.
🤖 Code Review — OpenCodeReview (Gemini) — No Issues FoundNo supported files changed. |
|
Thanks for updating your PR! It now meets our contributing guidelines. 👍 |
sahrizvi
left a comment
sahrizvi
left a comment
There was a problem hiding this comment.
Approving — the follow-up commit 3ed3f47 cleanly aligns default.txt and qwen.txt with anthropic.txt (docs-index instruction now identical across all three prompt files), and the core migration is complete and surgical.
One optional follow-up for consideration (not blocking this merge): a repo-wide grep surfaces three stale user-facing docs links on a legacy pattern (altimate.ai/docs/*) that wasn't in this PR's declared swap list and isn't touched here:
packages/core/src/v1/config/config.ts:45—https://altimate.ai/docs/commands→ likelyhttps://help.altimate.ai/code/configure/commands/packages/core/src/v1/config/config.ts:112—https://altimate.ai/docs/agents→ likelyhttps://help.altimate.ai/code/configure/agents/packages/opencode/src/cli/cmd/github.handler.ts:207—https://altimate.ai/docs/github/#usage-examples→ likelyhttps://help.altimate.ai/code/usage/github/#usage-examples
These are a config-schema description and CLI output, so users see them. Your call whether to fold them into this PR or track them separately (as was done for docs.altimate.ai under MAR-268) — either is fine; worth a tracking note either way.
3 participants
Issue for this PR
Closes #1006
Type of change
What does this PR do?
Replaces legacy documentation hostnames with canonical equivalents across the altimate-code codebase. Part of AI-7362 (URL canonicalization project).
The previous URLs relied on 301 redirects from legacy domains. This PR makes the canonical URLs explicit in source:
docs.altimate.sh/*→https://help.altimate.ai/code/*docs.myaltimate.com/*→https://help.altimate.ai/dbt-power-user/*datamates-docs.myaltimate.com/*→https://help.altimate.ai/datamates/*altimate.sh/*→https://altimate.ai/*(per page map; installer paths excluded)anthropic.txt,default.txt,qwen.txtprompt files aligned tohttps://help.altimate.ai/codeIntentionally excluded:
altimate.sh/installandaltimate.sh/install.ps1installer paths — left unchangeddocs.altimate.airefs — deferred pending slug→path mapdocs/docs/CNAMEandmkdocs.yml site_url— infrastructure config, not outbound links.github/workflows/— CI configHow did you verify your code works?
grep altimate.sh/installstill returns hitsScreenshots / recordings
N/A — no UI changes
Checklist
Requested by @saravmajestic via harness