Skip to content

docs: clarify opaque spec and wiki phrasing - #58

Merged
wcgomes merged 1 commit into
mainfrom
docs/clarify-spec-phrasing
Oct 9, 2026
Merged

wcgomes merged 1 commit into
mainfrom
docs/clarify-spec-phrasing

Conversation

@wcgomes

@wcgomes wcgomes commented Oct 9, 2026

Copy link
Copy Markdown
Owner

Clarity-only wording pass on specs and wiki. No contract change: normative strength is unchanged (MUST / MUST NOT, fail-closed, and warn-skip stay as written).

Opaque labels that hid their referent were rewritten:

  • matrix → the specific hook order, rows, URL scheme, color rules, or post-delete triggers
  • smuggling → collisions (runArgs flags for first-class properties, even if that property is unset)
  • remelt → kept as the operation name, glossed as re-merge and run on this start
  • carve-out → exception
  • analogue → stand-in / volume-mode counterpart
  • ood → docker-outside-of-docker
  • Wave A+B → the named allowlisted flags

Addresses #57

#57

@wcgomes
wcgomes merged commit f997740 into main Oct 9, 2026
1 check passed
@wcgomes
wcgomes deleted the docs/clarify-spec-phrasing branch October 9, 2026 03:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant