Skip to content

docs(releases): point two release-owned north-star links at the published URL - #26992

Merged
objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-26975-release-links-north-star
Oct 28, 2026
Merged

objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-26975-release-links-north-star

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #26975
Part of #26073

Clause-②: no
Metadata-protocol: none

维护者速读

What changes

Two link targets on release-owned surfaces, and nothing else:

  • CHANGELOG.md L1033: [north-star §8](content/docs/concepts/north-star.mdx) becomes [north-star §8](https://objectstack.ai/docs/concepts/north-star).
  • content/docs/releases/v17/17-6.mdx L1482-1483: the link that wraps across two lines keeps its text and line break; only its target (/docs/concepts/north-star) becomes (https://objectstack.ai/docs/concepts/north-star).

Diff: 2 files, +2 / -2. This is the dedicated docs-only PR the release-owned correction channel requires, kept out of #26970 for that reason. No changeset: nothing in any package's files[] moves (skip-changeset).

Tests

No code changed, so there are no unit tests. The acceptance reading on head 447b33e6e9:

$ git grep -n 'concepts/north-star' -- CHANGELOG.md content/docs/releases/
CHANGELOG.md:1033: ... see [north-star §8](https://objectstack.ai/docs/concepts/north-star) "No private expression DSL" ...
content/docs/releases/v17/17-6.mdx:1483:Star](https://objectstack.ai/docs/concepts/north-star) path on the published packages (#21318), and a

Acceptance notes

  • Why the https form is green on both sides of the rename was verified on origin/main (7bb8084590), not assumed. .github/workflows/check-links.yml sets LYCHEE_ARGS to start with --offline. Its comment there reads "Offline means only file:// targets are resolved -- every http(s) link is reported EXCLUDED, never requested." No line in lychee.toml does the exclusion: its exclude list names no objectstack.ai entry and is documented as inert under --offline. The flag is the mechanism. These links are therefore never fetched in CI, and the URL is also reachable today because the page exists until docs: one North Star — docs/NORTH-STAR.md; the architecture page moves to concepts/architecture-overview #26970 lands.
  • lychee is not installed in this container, so it was NOT MEASURED locally. This PR's Check Documentation Links run is the reading.

Verification

dispatch-gates: 50 derived commands, all exit 0, reconciled with --ran (head 447b33e)

node scripts/pm/dispatch-gates.mjs --commands --repo objectstack-ai/objectstack derived 50 commands from the merge-base change set (2 paths). Every command was run with its exit code captured before any pipe, and all 50 exited 0. Two commands first exited 3 (PREREQUISITE NOT MET: check:docs-transcript-drift needs @objectstack/lint built, and check:skill-examples needs @objectstack/client-react built). Each passed after its closure was built under the verify lock (VERDICT command-exit 0 both times).

Run reconciliation — 50 derived, 50 run, 0 NOT-MEASURED, 0 UNRUN.
✓ dispatch-gates --ran: 50 derived famil(ies) accounted for — 50 run, 0 NOT-MEASURED (a DERIVED zero — all 50 recorded an exit code and none of them is 3).

Selected verdict lines:

check-docs-redirects: OK (apps/docs/redirects.mjs: 98 entries ...)
✅ check-doc-anchors: 628 internal #fragment link(s) across 432 source file(s) all resolve to a real heading
check-release-notes: OK — every released major has a curated, navigable release page.
check-nul-bytes: OK (scanned 21719 text file(s) ... no raw ASCII control bytes).
✅ check-issue-citations: every citation this change adds resolves (or is a declared cross-repo reference).
✅ 267 prose examples type-check across 3 surface(s)

Generated by Claude Code

…shed URL

CHANGELOG.md and releases/v17/17-6.mdx linked the North Star page by
repo file path and by site route. Both now name
https://objectstack.ai/docs/concepts/north-star, which the offline link
check excludes and which resolves before and after the page rename.
Link text and surrounding history are unchanged.

Claude-Session: https://claude.ai/code/session_01QSeKYmTYfaPbLQD4BJfomW
Co-authored-by: Claude <noreply@anthropic.com>
@objectstack-fleet

Copy link
Copy Markdown
Contributor Author

席位核对 — ACCEPT · domain:devx#2 · head 447b33e6e9 · 2026-10-28T00:39Z

席位意见:合入。两处历史链接只换了目标地址,正文一字未动。它是 #26073 / PR #26970 落地的前置:本 PR 合入后,#26970 合 main,链接检查即转绿。

Shape: draft → main. Fixes #26975, Part of #26073. +2/−2 in 2 files: CHANGELOG.md L1033 and content/docs/releases/v17/17-6.mdx L1483. Assignee os-justin, label skip-changeset. Not governed.

Release-owned surface: content/docs/releases/** is touched under the devx lane's second channel: a factual correction goes through a dedicated docs-only PR (lanes/devx.md). The correction is the link target only. The seat checked both sentences against the diff: in the CHANGELOG, "see north-star §8" keeps its text and only the target changes; in 17-6, "North\nStar" keeps its text and line break, and only the target changes. Both now point at https://objectstack.ai/docs/concepts/north-star.

Premise (dev verified, seat re-read): CI's lychee runs --offline (the first token of LYCHEE_ARGS in check-links.yml), so https:// targets are excluded and never fetched. The PR is therefore green before and after #26970's rename, and the redirect in #26970 forwards readers to architecture-overview.

Gates: at head 447b33e6e9, 47 check-runs: 30 success, 17 skipped, 0 failure. Lint & Repo Gates, TypeScript Type Check and Check Documentation Links are all success. check-expected-skips: OK, all 17 skips are in main's roster. The dev's local union is 50 derived, 50 run, all exit 0.

Landing: ready + auto-merge now. Then the seat merges main into PR #26970, re-reads its link check, gets a delta contract review, and re-arms auto-merge.


Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/xs skip-changeset PR has no user-facing published change; bypasses the changeset gate

Projects

None yet

2 participants