docs: dire partout que la lecture par lot n'existe plus
Le contrat publie et l'api-contract etaient traites avec le retrait lui-meme ; restaient les documents qui decrivaient readUnion comme la primitive de lecture du paquet, ou qui nommaient le module disparu. Ce que les lecteurs apprennent maintenant : lire un document, c'est docs.sparqlQuery ancre dessus, et lire plusieurs documents, c'est cet appel une fois par document -- avec la decision sur une lecture qui echoue ecrite au point d'appel. Deux consequences sont dites plutot que decouvertes : une lecture refusee leve au lieu de rendre une liste vide, et les sujets sous le prefixe reserve urn:ng-eventually: reviennent dans le resultat, a l'appelant de les ignorer -- sans aucun gain de droits, les deux registres qu'un document ordinaire porte etant l'adresse de sa boite et, pour un document public, la cle que son magasin sert deja a qui la demande. Les briefs dates ne sont pas touches : ils decrivent un etat de juillet, et le reecrire falsifierait ce qui avait ete decide alors.
This commit is contained in:
@@ -22,9 +22,9 @@
|
||||
* The SDK's own shape query - `RdfOrmSubscription.getOrCreate(shapeType, scope)` - and
|
||||
* nothing of this library's own. Four steps went with the change, and they were one
|
||||
* mechanism: a logical scope resolved to a document set (`listMyEntityDocs`), those
|
||||
* documents opened through `ensureReposOpen` for a sync barrier, `readUnion` over them,
|
||||
* and a filter of the union by the shape's `@type` IRI. All four existed because the
|
||||
* parameter had to be TRANSLATED; once the parameter is upstream's own `Scope`, the
|
||||
* documents opened through `ensureReposOpen` for a sync barrier, one anchored read over
|
||||
* each of them, and a filter of the result by the shape's `@type` IRI. All four existed
|
||||
* because the parameter had to be TRANSLATED; once the parameter is upstream's own `Scope`, the
|
||||
* question goes straight to the thing that answers it. `graphs`, `subjects` and the
|
||||
* whole-dataset marker `did:ng:i` are now read by the engine, literally, and this module
|
||||
* does not interpret them at all - so the three readings are upstream's, not ours.
|
||||
|
||||
Reference in New Issue
Block a user