Package the chain, not just the chart
A result is reproducible only to the extent that its inputs, transformations and environment can be understood. Publish the protocol version, control-set version, observation schema, records or permitted derivatives, calculation code and result artifact as linked entities.
W3C provenance concepts are useful here: distinguish the entities, activities and responsible agents involved in creating a release. The implementation can remain simple while still preserving who did what with which input and version.
Minimum release contents
Include a plain-language readme, machine-readable metadata, data dictionary, inclusion flow, missing-data table, calculation definitions, execution instructions, dependency lock, known comparability breaks, license or rights statement and contact for corrections.
The package should name the tested environment and collection dates. “Latest” is not a version. A reader should be able to identify the exact release used by a report.
- Stable release identifier and publication date.
- Protocol, schema and control-set versions.
- Checksums for released files.
- Source and transformation provenance.
- Rights, exclusions and redistribution limits.
- Correction and supersession record.
Be precise about partial reproducibility
Public AI surfaces may change, and some outputs may not be redistributable. A later researcher may reproduce the procedure without receiving the same answer. Name whether the package supports computational reproduction, methodological review, rerunning the collection, or only inspection of aggregate calculations.
If a critical input cannot be inspected, do not use “fully reproducible.” Describe the remaining audit path and the resulting limit on the claim.
Treat corrections as part of the package
Never overwrite a released result without a trace. Publish the reason, affected files or observations, corrected version, reviewer and effect on conclusions. Preserve the prior release when lawful and practical.
A correction log is not a sign of weak research. It is the mechanism that lets a changing evidence base remain trustworthy.
Source notes
These sources support the definitions, standards or project boundaries named in this reference. They do not prove that a public observation dataset exists.
- nist-ai-rmf-genaiNIST AI RMF Generative AI ProfileOpen
Supports explicit measurement, documentation, monitoring and limitations for generative-AI evaluations.
- w3c-prov-oPROV-O: The PROV OntologyOpen
Provides provenance concepts for entities, activities, agents, derivations, sources and versions.
- rfc-3339RFC 3339: Date and Time on the InternetOpen
Supports an interoperable timestamp representation tied to UTC.
- fair-principlesThe FAIR Data PrinciplesOpen
Supports reusable research data with metadata, provenance and clear usage licenses.