Hoe u onze claims leest

Wat we denken, wat we hebben gebouwd en wat we van plan zijn, zijn drie verschillende dingen.

Organisaties die hun eigen werk beschrijven laten drie soorten uitspraken vaak in elkaar overlopen: wat ze geloven, wat ze hebben gedaan en wat ze van plan zijn te doen. Snel gelezen klinken alle drie als prestaties.

Wij proberen ze gescheiden te houden, omdat een partner die beslist of hij met ons wil werken moet kunnen zien wat wat is. Deze pagina legt uit hoe.

Drie soorten uitspraken

Positie. Hoe we over een probleem denken. De themapagina’s op deze site — Soevereiniteit, Veerkracht, Vroege waarschuwing, Verificatie, Capaciteitsoverdracht en AI-readiness — zijn posities. Ze leggen de onderscheidingen uit die we nuttig vinden, de fouten die we zien terugkeren en de toezeggingen die we over onze eigen claims doen. Over een positie kan worden gediscussieerd. Het is geen claim dat iets is gebouwd of bewezen.

Gebouwd. Iets dat bestaat en kan worden geïnspecteerd. Wanneer we zeggen dat we iets hebben gebouwd, is het operationeel en is er een manier om het te controleren. Machine Page Format (MPF) is een voorbeeld: de specificatie is gepubliceerd, de referentie-implementatie bestaat en deze site wordt ermee gepubliceerd. Iedereen kan de output ophalen en met de specificatie vergelijken.

Intentie. Iets dat we plannen of hebben ontworpen maar nog niet hebben gebouwd of bewezen. We beschrijven het als intentie, niet als prestatie. Ontwerp is een echte fase van werk met echte waarde. Het is niet hetzelfde als een werkend systeem, en we schrijven er niet over alsof dat wel zo is.

Wanneer een pagina deze categorieën mengt, zegt ze dat. Wanneer ze dat niet zegt, is de standaardregel dat themapagina’s posities zijn en standardspagina’s beschrijven wat is gebouwd.

Een declaratie is geen bewijs

Veel waarop instellingen vertrouwen wordt gedeclareerd in plaats van aangetoond: een verklaring van een leverancier over waar data worden verwerkt, een certificaat, een testrapport, een metadatafield. Declaraties zijn nuttig. Ze zijn niet hetzelfde als bewijs dat iets waar is.

Wij passen hetzelfde onderscheid op onszelf toe. Wanneer we iets over ons eigen werk zeggen, proberen we aan te geven waarop het rust: of het kan worden geïnspecteerd, of het is getest en onder welke omstandigheden, of dat het onze eigen beoordeling is.

Onbekend is een aanvaardbaar antwoord

Waar we iets niet weten, zeggen we dat. We laten liever een vraag open dan haar te vullen met een aanname die eruitziet als een bevinding.

Dat geldt evenzeer voor onze beoordelingen met partners als voor wat we publiceren. Een eerlijk “onbekend” vertelt een beslisser waar hij daarna moet kijken. Een zelfverzekerde gok vertelt hem niets en kan hem de verkeerde kant opsturen.

Smalle claims die standhouden

We verkiezen een smalle claim die reproduceerbaar is boven een brede claim die dat niet is. “Deze functie bleef vier uur doorgaan met verminderde dienstverlening nadat deze route verloren ging” klinkt minder indrukwekkend dan “veerkrachtig”. Het is ook iets dat een partner kan controleren, waarop hij kan vertrouwen en waarop hij kan voortbouwen.

Wanneer een resultaat alleen onder bepaalde omstandigheden geldt, vermelden we die omstandigheden. Wanneer we generaliseren, zeggen we dat we generaliseren.

Wat u hier niet zult vinden

We beschrijven werk op deze site pas wanneer het publiek is gelanceerd. U vindt hier geen initiatieven, formaten of diensten vóór dat punt, hoe ver hun ontwerp ook is gevorderd. U vindt geen partnerschappen geïmpliceerd door alleen de naam van een instelling te noemen. En u vindt geen capaciteiten aan ons werk toegeschreven die het werk nog niet heeft.

Dezelfde regel geldt voor companion.esfi.eu. De Shipyard op esfi.eu benoemt de initiatieven die we ontwikkelen; elk wordt hier gedocumenteerd zodra het is gelanceerd.

Dit is een bewuste keuze over de functie van documentatie. De waarde ervan hangt af van het vertrouwen van de lezer dat wat ze beschrijft werkelijk is wat ze zegt te zijn.

Wanneer ons standpunt verandert

Posities ontwikkelen zich. Bewijs verandert, en ons begrip verandert mee. Wanneer we een positie materieel wijzigen, werken we de pagina bij en zeggen we wat is veranderd, in plaats van stilzwijgend het ene standpunt door een ander te vervangen.

Elke themapagina bevat onderaan een kort wijzigingsregister: wanneer de positie voor het eerst is gepubliceerd en, voor elke materiële wijziging, de datum en wat veranderde. Correcties van formulering of links worden daar niet vermeld; inhoudelijke wijzigingen wel.

Gepubliceerde specificaties volgen een strengere regel: zodra een versie is gepubliceerd, blijft ze ongewijzigd beschikbaar en verschijnen veranderingen als nieuwe versies. Zie Versiebeheer.

Waarom dit voor ons belangrijk is

Het werk dat we doen vraagt partners claims zorgvuldiger te beoordelen: claims over controle, over veerkracht, over wat een machine leest, over welke capaciteit blijft. We kunnen dat niet van anderen vragen zonder het eerst op onszelf toe te passen.

Gerelateerd: Zes vragen die we stellen · Glossarium · Versiebeheer