Files
ng-eventually/.project/VOCABULARY.md
T
Sylvain Duchesne 737729c9ce refactor: le paquet s'appelle polyfill, « SDK » désigne celui de NextGraph
Le nom @ng-eventually/sdk entrait en collision avec le SDK de NextGraph, dont
ce paquet est justement un polyfill. Impossible d'écrire « le SDK » sans lever
l'ambiguïté à chaque phrase — et le contrat publié, lu par une application,
était le pire endroit pour laisser traîner ça.

packages/sdk → packages/polyfill, @ng-eventually/sdk → @ng-eventually/polyfill,
contract_sdk-surface → contract_polyfill-surface, e2e/sdk-entry.ts →
e2e/polyfill-entry.ts, docs/sdk-reference.md → docs/polyfill-reference.md.

Les occurrences de « SDK » qui désignent celui de NextGraph restent intactes,
y compris les chemins dans nextgraph-rs (sdk/js/orm, sdk/js/web). Le tri s'est
fait occurrence par occurrence, pas par substitution.

Le contrat énonce désormais son identité en une phrase : « This package is a
polyfill of NextGraph's SDK. »
2026-08-10 17:14:25 +02:00

750 B

Project vocabulary — canonical terms: use VERBATIM in any language, marked like this

  «app-contract»
   `reference`      a NURI that names a document and grants nothing — what an application circulates   (never: link, lien, share-link · see: contract_polyfill-surface)
   `ReadCap`        upstream's word for what opens a document — a reference carrying its secret        (never: token, credential, permission)
   `polyfill-era`   a published symbol with no counterpart in the target SDK, deleted at migration     (never: transitional, shim-only · see: knowledge_what-an-app-deletes-at-migration)