FORMATS / IDENTIFIANTS / MÉTHODES
Repères documentaires
Retrouver un identifiant, une unité, un statut HTTP ou une convention de données, puis ouvrir la méthode qui explique son usage et ses limites.
193 repères · page 8 sur 9
| Objet à vérifier | Code ou notation | Contexte et usage |
|---|---|---|
| Citation répétée : retrouver le passage avec son contexte | exact · prefix · suffix · matches | Une citation identique peut apparaître plusieurs fois dans un document. Web Annotation distingue le texte sélectionné, son préfixe et son suffixe immédiats. Le contexte sert à lever une ambiguïté ; il ne prouve ni l’auteur ni la véracité du passage. |
| Positions d’une citation : compter les points de code, pas les unités JavaScript | start / end · Unicode / UTF-16 · grapheme · resource changes | Un repère de début et de fin n’est reproductible que si le texte et l’unité de comptage restent identiques. TextPositionSelector compte les points de code Unicode dans l’ordre logique, même pour un texte de droite à gauche. |
| Citer un passage : distinguer la sélection et l’état de la source | selector · state / cached · sourceDate · W3C example 31 · HttpRequestState | Un repère de texte répond à « quel passage ? ». Un état répond à « quelle représentation de la ressource ? ». Dans un dossier de preuve ou une vérification de synthèse IA, conserver ces deux informations évite d’attribuer une citation à la mauvaise version. |
| Proportion observée : donner l’effectif et l’intervalle de Wilson | Observed proportion · Wilson score · Confidence level · x = 0 · Sampling model | Cinq observations positives sur vingt donnent 25 %, comme 250 sur 1 000. Sous un modèle binomial adapté, ces deux estimations n’ont pourtant pas la même précision. L’explorateur distingue le taux constaté, le niveau de confiance et les bornes calculées. |
| Comparer deux systèmes sur les mêmes cas : conserver les paires | a / d · b · c · m = b + c · Exact two-sided p | Deux taux globaux ne disent pas quels cas ont changé. Le tableau apparié classe chaque cas une seule fois selon les décisions de A et B, avec le même critère binaire. Le test exact de McNemar utilise les paires discordantes. |
| OCR : mesurer les erreurs avec une référence et un profil explicites | S / D / I · N / M · CER / WER (%) · units / profile · tie-break · N = 0 | La distance de Levenshtein compte les opérations minimales pour transformer une référence en texte candidat. Elle permet d’examiner une transcription ou un extrait, mais ne juge pas la fidélité d’une traduction ni la vérité d’une réponse. |
| Plusieurs documents OCR : sommer les erreurs et les références | corpus · document mean · example · alignment boundary | La moyenne simple des taux par document et le taux du corpus répondent à deux questions différentes. Le lecteur ci-dessous rend visibles les dénominateurs, y compris lorsqu’une référence est réellement vide. |
| Plages HTTP : bornes inclusives et longueur réellement sélectionnée | 0-499 · 500- / -200 · 1000- / 499-0 · 200 / 206 / 416 · Content-Encoding | Une reprise de transfert commence par le bon repérage des octets. Une plage HTTP est indexée à partir de zéro et ses deux bornes sont inclusives. Le calcul ci-dessous sépare la validité de la plage, sa satisfaisabilité pour une longueur connue et le comportement effectif du serveur. |
| Assembler des fragments : couverture, trous et identité de représentation | 0-399,300-599,700-999 · 0-499,500-999 · Content-Range · ETag · If-Range | Additionner les longueurs reçues peut masquer un téléchargement incomplet : un chevauchement compte plusieurs fois les mêmes positions. Il faut calculer l’union des intervalles, puis la comparer à la représentation visée. Ce contrôle géométrique reste distinct du contrôle des octets et de leur provenance. |
| JSON Merge Patch : supprimer, conserver ou remplacer une valeur | member absent · member: null · {} · null / [] / scalar · JSON values | Une mise à jour partielle doit annoncer son format. JSON Merge Patch décrit des valeurs à fusionner avec la cible ; JSON Patch décrit une liste d’opérations. Ces deux documents n’ont ni le même type de média ni le même traitement de null. Le simulateur permet d’examiner une fusion sans appeler une API. |
| JSON Patch : suivre les opérations sur le document courant | add · remove / replace · move · copy / test · HTTP PATCH · Content-Type | Une liste JSON Patch s’évalue dans l’ordre. Chaque chemin vise le document produit par les opérations précédentes, pas une photographie permanente du document initial. Les parcours ci-dessous montrent les états de calcul et les conditions d’arrêt sur neuf exemples originaux. |
| SemVer : comparer la priorité sans inventer une identité | MAJOR.MINOR.PATCH · 1.9.0 / 1.10.0 · -alpha.1 · -2 / -alpha · +001 | SemVer 2.0.0 définit une grammaire et un ordre de priorité pour les versions de logiciels qui déclarent une API publique. Le comparer comme une simple chaîne ou un nombre décimal produit des erreurs. Une date de jeu de données ou un nom de tag n’adopte pas automatiquement ce contrat. |
| SemVer : relier l’incrément à une modification déclarée | PATCH · MINOR · deprecated · MAJOR · 0.y.z / -rc.1 · released content | Un numéro ne permet pas à lui seul de découvrir l’impact d’un changement. Dans une API publique déjà versionnée en SemVer avec une majeure positive, l’équipe doit d’abord qualifier la modification. Le calculateur illustre ensuite l’incrément correspondant ; il ne réalise aucun audit de compatibilité. |
| BnF : distinguer le lieu de lecture, le catalogue et la copie numérique | 2023-06-10 · 1897 / 1932 / 1936 / 2022 · catalogue.bnf.fr / gallica.bnf.fr · ARK / edition / view · CC BY-SA 4.0 | Sous la verrière de la salle Ovale, les tables, les rayonnages et les lecteurs donnent une réalité matérielle à la recherche documentaire. Cette photographie situe la BnF Richelieu à Paris ; elle ne montre ni une page de Gallica ni la disponibilité en ligne d’un ouvrage. Pour retrouver une source, il faut passer du lieu à la notice, puis au document précis. |
| Archives nationales : relier une pièce, son fonds et son lieu de conservation | 2017-06-09 · 1705–1708 · 1808 / 1867 · fonds / series / reference · CC BY 2.0 | La cour d’honneur de l’hôtel de Soubise offre un repère concret pour le site parisien des Archives nationales. Mais reconnaître une institution sur une photographie n’établit pas où se conserve la pièce recherchée, si elle est numérisée ou comment elle peut être consultée. La recherche commence par la description du fonds et la référence de l’article. |
| Internet Archive : retrouver les composants d’une capture | 2011-12-09 / 2012-05-07 · HTML / CSS / image / JS · URL / timestamp · original URL / archived URL · CC BY-SA 3.0 | Cette baie portant le nom Internet Archive rappelle que les archives du Web reposent aussi sur une infrastructure matérielle. Steven Walling l’a photographiée au siège de San Francisco le 9 décembre 2011. Son image ne décrit ni l’équipement actuel ni le contenu d’une capture particulière de la Wayback Machine. |
| Une référence résolue peut avoir été corrigée | Crossmark · update-to · DOI | Un DOI qui s’ouvre identifie un document ; il ne suffit pas à connaître son état éditorial. Avant de reprendre une conclusion scientifique, recherchez les corrections, rétractations et autres mises à jour rattachées au travail. |
| Version corrigée ou nouvelle période : deux relations distinctes | dcat:hasVersion · dcat:previousVersion · dcat:inSeries | Une livraison annuelle et la correction d’un même fichier n’ont pas le même rôle. DCAT 3 permet de décrire explicitement les versions d’une ressource et les jeux appartenant à une série ; ces liens ne remplacent pas la lecture de la méthode. |
| Écriture HTTP : vérifier la version avant de remplacer un document | PUT · If-Match: "v1" · PUT · If-Match: "v2" · PUT · If-Match: W/"v2" · PUT · If-None-Match: * · GET · If-None-Match: W/"v2" · 428 | Deux personnes peuvent lire la même version puis envoyer des corrections différentes. Une précondition permet au serveur de refuser une écriture fondée sur une ancienne représentation. Les cas ci-dessous sont fictifs : v1 et v2 sont des étiquettes pédagogiques, pas des versions relevées sur un service. |
| Dates partielles : conserver la précision de la source | 2024 · 2024-02 · 2024-02-29 | Une publication peut n’indiquer qu’une année ou un mois. La compléter avec le premier janvier crée une précision absente du document. Comparez les périodes compatibles avant de placer deux événements dans une chronologie. |
| Recoupement : distinguer documents et origines | A: - · A: ? · B: A,C | Six pages qui se citent peuvent ne décrire qu’une seule observation. Pour une affirmation précise, construisez une carte des reprises avant de compter les confirmations. Les exemples et les règles de lecture ci-dessous sont une méthode pédagogique du site ; PROV-O documente les relations de provenance, sans fournir de score d’indépendance. |
| PubMed : contrôler la requête réellement interprétée | Search Details · Quoted phrase not found in phrase index · "A B"[tiab:~0] | Avant de conclure à une recherche négative, examiner la stratégie et les avertissements de la recherche. |
| Construire le panel : 20 cas structurés, 2 tirés, puis les parcours manquants | S01…S20 · R01, R02 · P01, P03, P04 · S ∪ R ∪ P | WCAG-EM 2.0, note de groupe du 23 juillet 2026, décrit un complément aléatoire égal à 10 % du panel structuré, hors cas déjà sélectionnés. Ce pourcentage porte sur le panel structuré, pas sur toutes les pages du site. La méthode inclut aussi les processus complets ; une URL seule peut manquer les états successifs d’un formulaire. |
| ACS : un entier négatif peut être un code, pas une quantité | E · -666666666 · E / M · -999999999 · E / M · -888888888 · M · -222222222 · M · -333333333 · M · -555555555 | L’American Community Survey du Census Bureau publie des codes numériques et des annotations associées. Garder ensemble E et EA pour l’estimation, M et MA pour la marge d’erreur. Ce dictionnaire concerne ce producteur ; il ne transforme pas tous les nombres négatifs en absences. |
Du format au fait : trois vérifications distinctes
Reconnaître la forme
Un identifiant conforme à un motif ou à une clé de contrôle peut encore désigner la mauvaise entité. Le contrôle du format élimine des erreurs de saisie ; il ne vérifie pas le titulaire.
Retrouver le bon objet
Ouvrez le registre ou le document correspondant. Comparez le nom, le périmètre, la version et la période avec la question posée. Conservez les identifiants techniques sans les traduire.
Qualifier la conclusion
Distinguez ce que la source déclare, ce que vous avez observé et ce qui reste à établir. Une valeur sans unité, période ou définition ne permet pas une comparaison fiable.
Les exemples de notation expliquent une règle. Ils ne constituent ni une certification ni une vérification en temps réel de votre dossier.
Contrôler les identifiants documentaires