Skip to content

Commit 3047ef3

Browse files
committed
fix(spec): the protocol-17 conversion summaries and three descriptions state their decisions in words
Stage 4 of the spec lane's runtime-string burn-down, class (b): the 56 toMajor-17 ADR-0087 conversion summaries (68 tracker ids) and three schema and route descriptions (3 ids) now state what each cited decision was, or drop a citation the sentence already explained. Text only: no conversion's id, surface, step, transform or order changes. Claude-Session: https://claude.ai/code/session_01YDt3PzwfrkuFzUBF89WPmM Co-authored-by: Claude <noreply@anthropic.com>
1 parent 1ac7308 commit 3047ef3

3 files changed

Lines changed: 65 additions & 64 deletions

File tree

‎packages/spec/src/api/plugin-rest-api.zod.ts‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -854,7 +854,7 @@ export const DEFAULT_METADATA_ROUTES: RestApiRouteRegistration = {
854854
+ 'comparison: the packaged baseline, the tenant customization row, and the merged '
855855
+ 'result side by side. A DIFFERENT representation from `GET /:type/:name`, which '
856856
+ 'answers only the merged value under `item` — hence its own path and its own '
857-
+ 'response schema (#5882). Reached until now only as `GET /:type/:name?layers=true`, '
857+
+ 'response schema, since one route answers one shape. Reached until now only as `GET /:type/:name?layers=true`, '
858858
+ 'which still works during its deprecation window but is answered with '
859859
+ '`Deprecation` / `Link` headers pointing here.',
860860
tags: ['Metadata'],
@@ -896,8 +896,9 @@ export const DEFAULT_METADATA_ROUTES: RestApiRouteRegistration = {
896896
+ '`op=\'publish\'` history event. The sibling write door of `PUT /:type/:name` — the '
897897
+ 'ADR-0033 two-step spelling, where `?mode=draft` stages a body and this makes it live. '
898898
+ '404 `NO_DRAFT` when there is nothing to publish; 409 `metadata_conflict` when the '
899-
+ 'published row advanced while the draft was held. Served since before #7294 with no '
900-
+ 'declaration behind it — this entry is what makes its response contract nameable.',
899+
+ 'published row advanced while the draft was held. The route was served for a long time with no '
900+
+ 'declaration behind it — this entry is what makes its response contract nameable, the same '
901+
+ 'declared-equals-returned rule the save door follows.',
901902
tags: ['Metadata'],
902903
// No `requestSchema` (#3899): the body is optional and its only read key
903904
// is `message`, taken only when it is already a string and ignored

0 commit comments

Comments
 (0)