docs(api): TRA-892 — docs-hygiene bundle (3 one-line fixes + groom contact.url deferral)#205
Merged
Merged
Conversation
…url deferral grooming Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…TCH no-op qualifier, BB version-check origin, retire contact.url deferral
Surfaced by the 2.6.1 black-box fleet (bb-261/262/263, svc v1.1.1-165-g8ca09556);
none gate launch.
1. BB_PRE_KEY.md: clarify current location is a scan projection (asset-locations
report / history endpoints), not a field on the asset object; reconcile the
parallel 'materialized location_id' line.
2. quickstart.mdx: empty PATCH {} is a no-op only against settable fields — it
still advances updated_at.
3. BB.md: fetch spec/build version from the app origin /health.json (carries
version + spec_refreshed_at); docs origin has only the docs build stamp.
4. BACKLOG.md: retire the 'restore info.contact.url' deferral — restored by
design (Stripe pattern, https://trakrf.id) via platform TRA-882.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
🚀 Preview Deployment Update ✅ This PR has been successfully merged into the preview branch. The preview environment will update shortly at: https://docs.preview.trakrf.id |
Deploying docs with
|
| Latest commit: |
6838343
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://d6b534e6.docs-4n7.pages.dev |
| Branch Preview URL: | https://preview.docs-4n7.pages.dev |
The all-bigint post-720 schema has landed (TRA-720 + the TRA-810 GKE migration); preview/prod run on it. Both deferred-registry rows whose trigger was 'bigint migration lands' are now resolved: - 'Bigint storage migration' (TRA-720) — done. - 'Path-param maximum constraint removal' (TRA-726 F2) — verified done in the live spec: surrogate path params now declare format: int64 + maximum: 9007199254740991 (no 2147483647 cap remains on any id). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
🚀 Preview Deployment Update ✅ This PR has been successfully merged into the preview branch. The preview environment will update shortly at: https://docs.preview.trakrf.id |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
TRA-892 — Docs-hygiene bundle (3 one-line fixes + groom
contact.urldeferral)Four documentation-hygiene items surfaced by the 2.6.1 black-box fleet (runs bb-261/262/263, svc
v1.1.1-165-g8ca09556). None gate the prod launch — zero service/contract defects were found.Spec:
superpowers/specs/2026-05-30-tra-892-docs-hygiene-bundle-design.mdPlan:
superpowers/plans/2026-05-30-tra-892-docs-hygiene-bundle.mdChanges
tests/blackbox/BB_PRE_KEY.md— current location is a scan projection (asset-locations report / history endpoints), not a field on the asset object; reconciled the parallel "materializedlocation_id" line so the doc stays consistent.docs/api/quickstart.mdx— emptyPATCH {}is a no-op only against settable fields (it still advancesupdated_at). The full behavior was already documented at:167; this closes the gap at the compressed mention.tests/blackbox/BB.md— fetch the spec/build version from the app origin/health.json(carriesversion+spec_refreshed_at); the docs origin's/health.jsoncarries only the docs build stamp.tests/blackbox/BACKLOG.md— retired the "restoreinfo.contact.url" deferral row. The URL was restored by design (Stripe pattern,https://trakrf.id) via platform TRA-882; the deferral is obsolete. (TRA-743 is already Done — Linear groomed separately with a comment.)Verification
pnpm build✅ (Redocusaurus fetches the live spec; no spec change here)prettier --check✅ on all changed/new filespnpm lintis red on pre-existing files (e.g. untouchedsuperpowers/specs/2026-05-30-tra-891-*); not introduced by this PR and intentionally left out of scope.Decisions (resolved autonomously)
🤖 Generated with Claude Code