Skip to content

docs: drop the hardcoded package versions from the utilities pages and correct the data-objectstack README install line - #4144

Merged
yinlianghui merged 1 commit into
mainfrom
claude/issue-4125-4130-docs-drift-pack
Aug 10, 2026
Merged

docs: drop the hardcoded package versions from the utilities pages and correct the data-objectstack README install line#4144
yinlianghui merged 1 commit into
mainfrom
claude/issue-4125-4130-docs-drift-pack

Conversation

@yinlianghui

Copy link
Copy Markdown
Collaborator

Fixes#4125
Fixes#4130

Two small docs-truth drifts on adjacent surfaces, one PR, one Fixes each. Both premises re-verified on origin/main = 148ade326 before implementing; both still held.

#4125 — hardcoded **Version:** 0.3.1 in the utilities Package Information blocks

Both lines claimed 0.3.1 while both manifests read 17.4.0. Taken the removal direction, per the card's own first option.

The decisive evidence for removing rather than updating is that this repo already made the call, twice, on the same page family: commit 616353ad1 (#3577) replaced **Version:** 0.3.1 in runner.mdx with a pointer to the npm page, and b1204af0a (#3715) did the same for create-plugin.mdx. Of the four ## Package Information blocks under content/docs/utilities/, two had already shed the hardcoded version and two had not — so this change finishes a convention rather than inventing one. Verified that nothing renders or reads these lines specially: they are plain bold markdown, and a repo-wide search for code touching a Version: line or injecting versions into docs finds nothing.

The two pages are treated slightly differently, deliberately:

  • data-objectstack.mdx follows the runner.mdx precedent exactly — the package name line gains "published on npm, see the npm page for the current version". The package is publishable (no private flag) and its own README already links that npm page, so the pointer is a claim I can stand behind.
  • vscode-extension.mdx drops the version line with no replacement pointer. The parallel move would be "see the Marketplace listing", but packages/vscode-extension/package.json carries "private": true, so I could not verify a live Marketplace listing — and adding an unverified availability claim is the exact class of defect these cards exist to remove. Bare removal is the edit I can prove correct; whether that page's existing "search the Extensions panel for ObjectUI" instructions are accurate is a separate question this PR does not touch.

Sweep result — the card's "only two such lines" claim is correct, but a third instance of the same stale value exists in another shape. A broader hardcoded-version grep over content/docs/ found vscode-extension.mdx:30:

code --install-extension objectui-0.3.1.vsix

Wrong twice over: vsce package names its output NAME-VERSION.vsix from the manifest, so with "name": "object-ui" at 17.4.0 the real file is object-ui-17.4.0.vsix — the doc used the publisher segment and the stale version. Replaced with the placeholder form rather than the current number, so it cannot re-drift. (Written in this description with spaces inside the angle brackets — object-ui-< version >.vsix — because GitHub's body sanitizer eats a bare angle-bracket-plus-letter; the file itself has no spaces.)

The only other version-shaped hit under content/docs/ is guide/plugins.md:374's "version": "1.0.0" inside an example plugin manifest — a template for the reader's own package, not a claim about ours. Left alone.

#4130 — README told readers to install @objectstack/client separately

packages/data-objectstack/README.md:16 still carried npm install @object-ui/data-objectstack @objectstack/client. Confirmed against the manifest: the package declares nopeerDependencies at all, and @objectstack/client sits in dependencies at ^17.0.0-rc.5. The install line and the note now match content/docs/utilities/data-objectstack.mdx verbatim, which is where PR #4127 landed the corrected wording.

Whole-README dependency-contract sweep (the #3781 discipline), all other candidates checked and found clean:

  • No occurrence of "peer" anywhere in the README — no false peer claim to correct.
  • The usage example imports SchemaRenderer from @object-ui/react, which is not a dependency of this package. Left as-is and not added to the install line: the corrected docs page states the same relationship in prose ("React wiring lives in @object-ui/react, not here"), so the README is consistent with it. Adding the package to the install command would be inventing a contract claim, the opposite of what this card asks for.
  • ## Links targets resolve: ./CHANGELOG.md, ./LICENSE, and the relative content/docs/guide/user-state-persistence.md all exist.

Verification

GateResult
node scripts/check-doc-links.mjsLinks are valid across 7 scan roots.
node scripts/check-control-bytes.mjsOK (scanned 3836 tracked text file(s); skipped 85 binary)
node scripts/check-changeset-presence.mjsNo source of a released package changed in this range, so no changeset is owed.
turbo run build --filter=@object-ui/site --force29 successful, 29 total; Generating static pages (556/556)

The site build was run with --force because turbo does not hash content/docs (the #4124 finding), so a cached build would not have exercised these files.

The build was not just a smoke test — the placeholder edit puts angle brackets into an MDX file, so the rendered output was read back to confirm MDX treated it as code text rather than parsing it as a JSX element. Built HTML for /docs/utilities/vscode-extension contains the command with the placeholder intact, and its Package Information block now renders Extension ID: objectui.object-ui straight into License: MIT. Neither built page contains 0.3.1 any more (0 occurrences in each), and no changeset is owed since this is docs and README prose only.

Out of scope, filed not fixed


Generated by Claude Code

…d correct the data-objectstack README install line (#4125, #4130)
Fixes#4125 — the two `**Version:** 0.3.1` lines under content/docs (both
packages ship 17.4.0) plus a third instance of the same stale value in the
vscode-extension `.vsix` install command.
Fixes#4130 — packages/data-objectstack/README.md told readers to install
`@objectstack/client` alongside the adapter; it is a regular dependency.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017Qqyix2QcnpUC9XeYVDzx3
@vercel

vercelBot commented Aug 10, 2026

Copy link
Copy Markdown

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

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredAug 10, 2026 1:29pm

Request Review

@github-actionsgithub-actionsBot added documentation Improvements or additions to documentation data-adapter labels Aug 10, 2026
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)28.3 KB350 KB
Entry fileindex-DLJtlNtN.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)8.66KB3.13KB
app-shell (runtime-config.js)7.42KB2.32KB
app-shell (types.js)0.01KB0.04KB
app-shell (urlParams.js)7.57KB2.97KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)22.10KB4.37KB
auth (AuthShell.js)3.49KB1.40KB
auth (ForgotPasswordForm.js)12.21KB3.45KB
auth (LoginForm.js)18.13KB5.39KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.64KB2.21KB
auth (SocialSignInButtons.js)9.60KB3.89KB
auth (UserMenu.js)3.40KB1.22KB
auth (auth-gate-events.js)1.29KB0.66KB
auth (authStyles.js)5.04KB1.72KB
auth (createAuthClient.js)35.76KB9.11KB
auth (createAuthenticatedFetch.js)4.37KB1.69KB
auth (index.js)2.35KB1.07KB
auth (org-roles.js)6.66KB2.78KB
auth (phone-identifier.js)1.11KB0.66KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)4.91KB0.87KB
auth (useIsWorkspaceAdmin.js)1.61KB0.85KB
collaboration (CommentThread.js)26.07KB7.56KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)6.49KB2.64KB
collaboration (PresenceProvider.js)2.79KB1.13KB
collaboration (index.js)1.65KB0.73KB
collaboration (useCollaborationTranslation.js)6.05KB2.52KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)485.06KB107.21KB
core (index.js)3.04KB1.15KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)140.66KB36.25KB
fields (index.js)229.40KB56.93KB
i18n (LocalizationContext.js)1.76KB0.96KB
i18n (currency.js)1.22KB0.64KB
i18n (i18n.js)4.32KB1.77KB
i18n (index.js)2.65KB1.06KB
i18n (pickLocalized.js)1.70KB0.83KB
i18n (provider.js)9.48KB3.27KB
i18n (useObjectLabel.js)27.59KB6.63KB
i18n (useSafeTranslation.js)4.52KB1.96KB
layout (index.js)38.87KB10.80KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (createOfflineDataSource.js)5.61KB1.74KB
mobile (index.js)1.50KB0.62KB
mobile (offlineQueue.js)3.91KB1.35KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (serviceWorkerSource.js)3.41KB1.48KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)6.96KB1.98KB
mobile (useOfflineSync.js)1.99KB0.72KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)4.32KB1.64KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (MePermissionsProvider.js)8.75KB3.06KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.67KB1.12KB
permissions (evaluator.js)4.41KB1.44KB
permissions (index.js)0.91KB0.41KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)1.55KB0.71KB
plugin-ai (index.js)15.71KB3.79KB
plugin-calendar (index.js)45.23KB12.45KB
plugin-charts (index.js)61.52KB17.49KB
plugin-chatbot (index.js)180.33KB42.79KB
plugin-dashboard (index.js)118.52KB30.68KB
plugin-designer (index.js)210.51KB42.51KB
plugin-detail (index.js)237.80KB59.48KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)114.58KB27.68KB
plugin-gantt (index.js)162.81KB39.67KB
plugin-grid (index.js)188.04KB49.91KB
plugin-kanban (index.js)48.60KB13.41KB
plugin-list (index.js)110.04KB26.67KB
plugin-map (index.js)17.00KB5.32KB
plugin-markdown (index.js)13.72KB4.69KB
plugin-report (index.js)40.58KB10.58KB
plugin-timeline (index.js)26.21KB7.52KB
plugin-tree (index.js)8.50KB2.88KB
plugin-view (index.js)84.03KB20.55KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.90KB0.85KB
providers (UploadProvider.js)11.71KB3.53KB
providers (index.js)0.44KB0.22KB
providers (types.js)0.01KB0.04KB
react-runtime (index.js)5.67KB2.37KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)23.71KB7.95KB
react (data-invalidation.js)5.05KB2.08KB
react (index.js)1.23KB0.66KB
react (spec-input.js)0.20KB0.18KB
sdui-parser (codegen.js)4.09KB1.74KB
sdui-parser (index.js)4.47KB2.03KB
sdui-parser (parse.js)10.04KB2.82KB
sdui-parser (types.js)0.29KB0.24KB
sdui-parser (validate.js)4.69KB1.48KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)1.87KB0.85KB
types (disclosure.js)0.20KB0.18KB
types (error-code.js)1.54KB0.88KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (http-retry.js)4.32KB2.02KB
types (index.js)2.71KB1.34KB
types (layout.js)0.20KB0.18KB
types (managed-by.js)0.19KB0.18KB
types (mobile.js)2.59KB1.31KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (record-semantics.js)1.28KB0.67KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (spec-report.js)5.05KB1.93KB
types (system-fields.js)3.33KB1.54KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)3.40KB1.71KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@yinlianghui
yinlianghui marked this pull request as ready for review August 10, 2026 13:38
@yinlianghui
yinlianghui added this pull request to the merge queueAug 10, 2026
Merged via the queue into main with commit d86d372Aug 10, 2026
19 checks passed
@yinlianghui
yinlianghui deleted the claude/issue-4125-4130-docs-drift-pack branch August 10, 2026 13:38
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

data-adapterdocumentationImprovements or additions to documentation

Projects

None yet

2 participants

@yinlianghui@claude