docs: nommer les deux lectures, et dire laquelle est une primitive

This commit is contained in:
Sylvain Duchesne
2026-09-21 13:40:35 +02:00
parent d0ea043a5b
commit 05a0f7b148
2 changed files with 16 additions and 7 deletions
+9 -7
View File
@@ -4,15 +4,17 @@
```text ```text
«app-contract» «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) `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) `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) `shape read` a read whose selector is a ShEx shape, i.e. which predicates an object carries, never a list of documents (never: typed read, shape-based read, lecture par forme · see: knowledge_what-a-read-scope-is-upstream)
`document read` a read selected by naming documents - upstream anchors ONE, so naming several is this package's own composition (never: bulk read, union read, lecture par document)
`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)
«e2e-harness» «e2e-harness»
`journey` one named end-to-end story in the applicative suite, reported pass or fail as a whole (never: scenario, test case, spec) `journey` one named end-to-end story in the applicative suite, reported pass or fail as a whole (never: scenario, test case, spec)
`batch` one run of a suite, which mints its own physical user and discards the previous one (never: session, campaign) `batch` one run of a suite, which mints its own physical user and discards the previous one (never: session, campaign)
«sign-in» «sign-in»
`settle` decide which identity is acting, from the URL, storage, or the barrier — needs no session (never: resolve identity, determine user, login · see: knowledge_settling-is-not-connecting) `settle` decide which identity is acting, from the URL, storage, or the barrier — needs no session (never: resolve identity, determine user, login · see: knowledge_settling-is-not-connecting)
`barrier` the full-screen overlay this package mounts to hand out the wallet and take an identifier (never: modal, popup, login screen) `barrier` the full-screen overlay this package mounts to hand out the wallet and take an identifier (never: modal, popup, login screen)
``` ```
@@ -19,6 +19,13 @@ vocabulary:
- term: ReadCap - term: ReadCap
gloss: upstream's word for what opens a document — a reference carrying its secret gloss: upstream's word for what opens a document — a reference carrying its secret
not: [token, credential, permission] not: [token, credential, permission]
- term: shape read
gloss: a read whose selector is a ShEx shape, i.e. which predicates an object carries, never a list of documents
not: [typed read, shape-based read, lecture par forme]
see: knowledge_what-a-read-scope-is-upstream
- term: document read
gloss: a read selected by naming documents - upstream anchors ONE, so naming several is this package's own composition
not: [bulk read, union read, lecture par document]
- term: polyfill-era - term: polyfill-era
gloss: a published symbol with no counterpart in the target SDK, deleted at migration gloss: a published symbol with no counterpart in the target SDK, deleted at migration
not: [transitional, shim-only] not: [transitional, shim-only]