Skip to content

docs: drop refused dotted-fields remedy from v17 release notes - #8393

Merged
qq9340100 merged 1 commit into
mainfrom
claude/issue-8329-v17-dotted-fields-remedy
Aug 13, 2026
Merged

docs: drop refused dotted-fields remedy from v17 release notes#8393
qq9340100 merged 1 commit into
mainfrom
claude/issue-8329-v17-dotted-fields-remedy

Conversation

@qq9340100

Copy link
Copy Markdown
Collaborator

Fixes#8329

Sanctioned shape

This is the dedicated docs-only PR for a content/docs/releases/ factual error, per the release-notes guardrail (AGENTS.md / CLAUDE.md): release pages are release-owned and read-only in a code PR, so this correction lands as its own PR rather than a rider on any code change. Nothing outside the one table cell below is touched, and this PR carries no changeset (docs-only, skip-changeset applied — see below).

What changed

content/docs/releases/v17.mdx line 977, the removed-features row for the retired fields[] object form { field, fields, alias }, prescribed in its "Use instead" column:

expand, or a dotted path for a single related column (fields: ['owner.name'])

The dotted-path half of that remedy is now refused at both doors: 400 INVALID_FIELD at the REST ingress (PR #7588) and on direct engine.find / engine.findOne calls (PR #8327). Following the published remedy would land an upgrader in the exact refusal it was meant to route around.

Per the card's own prescription (already triaged as settled), the cell now reads:

expand, keeping the reference column in the projection (fields: ['title', 'owner'] plus expand)

The dotted alternative is dropped, not reworded — the relation is carried by the projected column, so removing that column would leave expand nothing to resolve.

Verification

  • pnpm check:docs-audit-scope — pass
  • pnpm check:quick-reference-counts — pass
  • pnpm check:release-notes — pass
  • pnpm check:role-word — pass
  • pnpm --filter @objectstack/lint run check:doc-formula-expressions — pass (required building packages/formula's dist first via pnpm --filter '@objectstack/lint^...' build in this fresh worktree)
  • pnpm check:nul-bytes — pass
  • Re-derived against the actual changed path with node scripts/pm/dispatch-gates.mjs content/docs/releases/v17.mdx — surfaced exactly the five gates above, no additions.

Generated by Claude Code


Generated by Claude Code

The v17.mdx removed-features row for the fields[] object form
prescribed a dotted path (fields: ['owner.name']) as a fallback
alongside expand. That spelling is now refused at both doors (REST
ingress since #7532/PR #7588, engine find/findOne since #7589/PR
#8327), so the remedy pointed upgraders straight into the refusal
it was meant to route around.
Per the card's own prescription: drop the dotted alternative, keep
expand alone with the reference column preserved in the projection.
Fixes#8329
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jqe56GnYFddggeAyfkZFVz
@vercel

vercelBot commented Aug 13, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectstackIgnoredIgnoredAug 13, 2026 10:55am

Request Review

@qq9340100qq9340100 added the skip-changeset PR has no user-facing published change; bypasses the changeset gate label Aug 13, 2026 — with Claude
@github-actionsgithub-actionsBot added the documentation Improvements or additions to documentation label Aug 13, 2026
@qq9340100
qq9340100 marked this pull request as ready for review August 13, 2026 11:17
@qq9340100
qq9340100 added this pull request to the merge queueAug 13, 2026
Merged via the queue into main with commit f3fb618Aug 13, 2026
25 checks passed
@qq9340100
qq9340100 deleted the claude/issue-8329-v17-dotted-fields-remedy branch August 13, 2026 11:34
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/xsskip-changesetPR has no user-facing published change; bypasses the changeset gate

Projects

None yet

2 participants

@qq9340100@claude