ML data engineering
Dataset Documentation, Governance, and Use Review
Create evidence-linked documentation and governance decisions that guide appropriate dataset use and retirement.
By the end you can
- Describe the evidence a maintained dataset datasheet should contain
- Distinguish documentation, use approval, and ongoing monitoring
- Evaluate proposed uses against population, rights, limitations, and consequence
- Plan deprecation and retirement of dataset releases
Visual
A reviewable dataset package combines narrative and executable evidence
Different artifacts answer different questions about the same release, and the families they have to cover are not a matter of house style. The canonical form is the datasheet, proposed in 2018 by Gebru and colleagues and published in Communications of the ACM three years later: “By analogy, we propose that every dataset be accompanied with a datasheet that documents its motivation, composition, collection process, recommended uses, and so on.”
That proposal has an operational descendant inside a company. Microsoft's Aether Data Documentation Template, drafted in 2022, organises the same material under eight headings — Dataset Contents; Intended & Inappropriate Uses; Data Collection Procedures; Representativeness; Data Quality; Pre-processing, Cleaning, and Labeling; Privacy; and Additional Details on Distribution & Access. Its question 8 is literally “What are some tasks/purposes that this dataset is not appropriate for?” One is an academic proposal, the other a working internal template. They converge on the same five families of evidence, and both turn inappropriate use from a caveat somebody might add into a numbered question somebody has to answer.
Purpose and decision context — motivation, intended users, prediction or analysis task, and unacceptable uses. That is the datasheet's motivation and recommended uses, and the template's Intended & Inappropriate Uses with its question 8.
Composition and coverage — population, units, time range, geography, modalities, exclusions, and missing groups. Composition in the datasheet; Dataset Contents and Representativeness in the Aether headings.
Creation process — sources, consent, instrumentation, labeling, cleaning, transformation, and sampling. The datasheet's collection process; Data Collection Procedures plus Pre-processing, Cleaning, and Labeling in the template.
Quality and limitations — known errors, uncertainty, slice coverage, shift risks, and validation evidence. The Aether heading is Data Quality. It is also the heading whose contents a reviewer can most easily go and recompute.
Operations and governance — owner, access, retention, versioning, incident history, updates, and retirement. Privacy together with Additional Details on Distribution & Access, and the family that decays fastest once the release stops being maintained.
Purpose and decision context
Motivation, intended users, prediction or analysis task, and unacceptable uses.
Composition and coverage
Population, units, time range, geography, modalities, exclusions, and missing groups.
Creation process
Sources, consent, instrumentation, labeling, cleaning, transformation, and sampling.
Quality and limitations
Known errors, uncertainty, slice coverage, shift risks, and validation evidence.
Operations and governance
Owner, access, retention, versioning, incident history, updates, and retirement.
Narrative context should point to evidence that can be inspected or reproduced.
Example
A dataset is reused outside the population it documented poorly
A speech dataset collected from call-center agents is proposed for a public accessibility product. Work this one as a constructed exercise rather than a reported case, and check each line against the evidence families above. Every fact a reviewer needs is a documentation field that either exists in the release or does not.
- The original population excludes children, many dialects, and users with speech impairments — a composition and coverage failure that no accuracy number will surface.
- Noise conditions reflect controlled headsets rather than mobile devices and public spaces, so the creation process, not the model, sets the ceiling on deployment performance.
- Consent covers quality monitoring but not external product development, which is a rights question the datasheet records and the use review has to answer.
- Transcripts were corrected by staff using internal terminology, so the labels encode a vocabulary the new users do not share.
- The dataset appears large and accurate, yet its intended-use boundary is fundamentally different — exactly what the Aether template's question 8 exists to make someone write down.
Comparison
Documentation, approval, and monitoring answer different questions
A strong governance process connects all three without confusing them.
Dataset documentation explains origin, composition, process, limitations, and maintenance. It supports discovery and makes assumptions visible. It needs an owner and a version. It does not grant permission to anybody for anything.
Use review determines whether a proposed use is allowed and appropriate. It weighs purpose and consequence, checks rights and population fit, can impose controls, and produces an accountable decision attached to a named body.
Ongoing monitoring checks whether the approved use stays within its conditions. It tracks drift and incidents, detects scope expansion, reviews retention and access, and can trigger reapproval or retirement.
The three fail in different ways, which is the practical reason to keep them apart. Documentation fails by going stale. Approval fails by being granted in the abstract. Monitoring fails by watching the dataset rather than the use.
Dataset documentation
Explains origin, composition, process, limitations, and maintenance.
- Supports discovery
- Makes assumptions visible
- Does not grant permission
- Needs an owner and version
Use review
Determines whether a proposed use is allowed and appropriate.
- Considers purpose and consequence
- Checks rights and population fit
- Can impose controls
- Produces an accountable decision
Ongoing monitoring
Checks whether the approved use remains within conditions.
- Tracks drift and incidents
- Detects scope expansion
- Reviews retention and access
- Can trigger reapproval or retirement
Steps
Run a dataset-use review
Review the proposed use against the release evidence rather than approving the dataset in the abstract. A working example exists, and it is documented. UK Biobank holds a cohort of over 500,000 participants recruited between 2006 and 2010, opened to outside researchers through an online access process launched in April 2012. Sudlow and colleagues described how it runs in PLOS Medicine in 2015. Data-only applications are approved if the research is in the public interest. Applications that use depletable samples or require participant re-contact go through more rigorous scientific review. “Following initial assessment by the executive team, all applications are assessed and either approved or rejected (with right of appeal) by an independent Access Subcommittee.” Researchers receive only de-identified data and must sign a material transfer agreement not to re-identify participants and to use the data only for the approved research. In the first two years over 1,000 researchers registered and over 200 applications were submitted; roughly 85% were for data only. The HMA-EMA Catalogues of real-world data sources record the same arrangement from the regulator's side: biospecimen access requires a “Request to be made in the research application for approval”.
1. Name the proposed decision. Describe user, action, consequence, geography, and operating environment. UK Biobank's two-tier rule is keyed to exactly this: what the applicant intends to consume determines how hard the scrutiny is.
2. Compare populations. Assess coverage, exclusions, proxies, missing groups, and expected shift. A cohort recruited 2006-2010 answers some questions and silently fails others.
3. Check rights and purpose. Verify consent, license, contractual limits, retention, and deletion duties. The material transfer agreement is where those duties become enforceable rather than aspirational.
4. Review quality evidence. Inspect labels, slices, unresolved errors, provenance, and incident history. Recompute enough of it to know the narrative matches the artifact.
5. Set conditions. Define access, monitoring, human review, documentation, and expiry requirements. De-identification, a non-re-identification covenant, and approval scoped to one stated research question are three separate controls, not one.
6. Record the decision. Publish approver, rationale, dissent, review date, and triggers for reconsideration. A named Access Subcommittee with a right of appeal is what makes a decision reviewable later. An unnamed approver is accountable to nobody.
1. Name the proposed decision
Describe user, action, consequence, geography, and operating environment.
2. Compare populations
Assess coverage, exclusions, proxies, missing groups, and expected shift.
3. Check rights and purpose
Verify consent, license, contractual limits, retention, and deletion duties.
4. Review quality evidence
Inspect labels, slices, unresolved errors, provenance, and incident history.
5. Set conditions
Define access, monitoring, human review, documentation, and expiry requirements.
6. Record the decision
Publish approver, rationale, dissent, review date, and triggers for reconsideration.
Key idea
A completed datasheet is not proof of compliance or fitness
Documentation can be incomplete, outdated, self-serving, or disconnected from the actual artifacts. It can also describe limitations accurately and still leave the proposed use unacceptable. The weakness is measurable. Every dataset repository on Hugging Face was counted in March 2023, and the count is not flattering. Of 24,065 repositories, only 58.2% — 14,011 — had a README dataset card at all, and 6,578 of those were empty. That leaves 30.9%, or 7,433, with a card that says anything. Yang and colleagues reported it at ICLR in 2024.
Completion tracks attention rather than risk. Among the hundred most-downloaded datasets, 86.0% of cards filled in every community-suggested section. Among datasets with no downloads, 7.9% did. And the section that governs appropriate use is the thinnest one written: “In contrast, the Considerations for Using the Data section receives the lowest proportion of content, accounting for just 2.1% of the text.” Social impact, biases and limitations get 2.1% of card length. Dataset Description gets 36.2% and Dataset Structure 33.6%. "Somebody filled one in" is a weak signal by measurement, not merely by suspicion.
Reviewers should sample source evidence, reproduce key statistics, and verify that access and retention controls match the narrative. BookCorpus is what happens when nobody does. It is the dataset behind OpenAI's GPT-N and Google's BERT, and Bandy and Vincent wrote it a retrospective datasheet in 2021: “We also find that thousands of books in BookCorpus are duplicated, with only 7,185 unique books out of 11,038 total.” The headline count did not survive the recount. Some 2,930 titles were duplicated, 2,101 of them appearing exactly twice and six appearing five times, alongside books whose own text carries 'all rights reserved' style copyright declarations. The 11,038 figure was not an outsider's guess. It was the creators' own, stated in the 2015 paper that introduced the corpus: “In order to train our sentence similarity model we collected a corpus of 11,038 books from the web.” One number, stated in good faith by the people who built it, restated for years, and wrong by a third the first time anyone recomputed it.
Material omissions should block approval or lower confidence. The document exists to make the dataset legible and to feed a review, not to certify it.
Transparency makes judgment possible; it does not replace judgment.
Analogy
Documentation is a building's technical file
The schema is the floor plan, lineage the construction records, quality reports the inspections, and the datasheet the file explaining intended occupancy and known limitations. A future tenant can decide whether the building suits a laboratory, school, or warehouse only if those records are maintained and specific. Dataset populations keep changing after release, and so does the way records are collected. The technical file therefore has to be updated more often than many physical ones. And a technical file that has never been checked against the building describes an intention, not a structure.
Documentation supports responsible reuse when it remains connected to versions, evidence, and decisions.
Datasets need deprecation and retirement plans
Datasets become obsolete when their population changes, rights expire, source systems are replaced, labels lose meaning, or a better release supersedes them. Leaving old versions discoverable without warnings invites accidental reuse.
Mark deprecated releases, identify active consumers, set migration dates, preserve required evidence, revoke access, and apply deletion policy to derived artifacts. Retirement should also update feature registries and training recipes.
Retirement rarely works by announcement alone, and the failure has been counted. Three Princeton researchers went through nearly 1,000 papers citing Labeled Faces in the Wild, MS-Celeb-1M and DukeMTMC. MS-Celeb-1M alone had 1,404 citing papers, 8 derivative datasets and 21 GitHub repositories of pre-trained models. The original licence permitted only non-commercial research use; 3 of those 21 repositories carried the same designation. MS-Celeb-1M and DukeMTMC were retracted in April 2019 and were still in use in 2020, largely through derivatives. Peng and colleagues state it flatly: “Our analysis shows that even after DukeMTMC and MS-Celeb-1M were retracted, their underlying data remained widely available and continued to be used in research papers.” The independent Exposing.ai investigation by Adam Harvey and Jules LaPlace documents the same pattern from the other side: “Despite the recent termination of the msceleb.org website, the dataset still exists in several repositories on GitHub, the hard drives of countless researchers, and will likely continue to be used in research projects around the world.” Revoking access is not revoking use. A step that says "identify active consumers" has 21 repositories and 8 derivative datasets to identify, for one dataset.
Deletion policy for derived artifacts is not a drafting preference either. It has been ordered. In 2021 the US Federal Trade Commission settled with the photo app developer Everalbum and required it to delete "(A) photos and videos of Ever app Users who requested deactivation of their accounts, (B) face recognition data that it created without obtaining Users' affirmative express consent, and (C) models and algorithms it developed in whole or in part using images from Users' photos." The third item is the one that mattered: an early and unusually explicit case of a regulator ordering the deletion of models built from improperly collected data, not just the data. Commissioner Rohit Chopra put the principle plainly: “First, the FTC's proposed order requires Everalbum to forfeit the fruits of its deception. Specifically, the company must delete the facial recognition technologies enhanced by any improperly obtained photos.” Everalbum's enterprise brand was Paravision. The Commission finalised the settlement on 7 May 2021 by a 4-0 vote, and the order runs for 20 years. A trained model is a derived artifact, and “models and algorithms it developed in whole or in part using images from Users' photos” is what a retirement plan has to be able to enumerate before anyone asks it to.
Where exact deletion is impossible, document residual copies, legal basis, access restrictions, and the limits of future reconstruction.
The lifecycle is incomplete until consumers can stop using the dataset safely.
Documentation is part of the dataset interface
A consumer needs to know why a dataset exists, how it was collected, who is represented, which transformations were applied, and where it should not be used. Code and schema cannot answer those questions alone.
A datasheet or dataset card creates a structured conversation between creators, maintainers, reviewers, and downstream teams. Its value comes from evidence and ownership, not from the fact that somebody filled one in.
Language data got its own version of the artifact. Bender and Friedman proposed data statements in 2018: “In this paper, we propose data statements as a design solution and professional practice for natural language processing technologists, in both research and development.” The schema named curation rationale, language variety, speaker and annotator demographics, and speech situation and text characteristics.
What happened to that schema afterwards is the interesting part. It was revised after a 2020 workshop and republished in 2021 as Version 2, by the original authors joined by Angelina McMillan-Major. It now carries 15 numbered elements: Header, Executive Summary, Curation Rationale, Documentation for Source Datasets, Language Varieties, Speaker Demographic, Annotator Demographic, Speech Situation and Text Characteristics, Preprocessing and Data Formatting, Capture Quality, Limitations, Metadata, Disclosure and Ethical Review, Other, and Glossary. A documentation standard that was itself revised, versioned and republished three years after its proposal is the strongest available argument that the documents written against it are not finished objects either.
Documentation should therefore evolve with each release and link to executable artifacts such as contracts, quality reports, lineage, and approved access policies.
A dataset without maintained context becomes an undocumented dependency with social and technical consequences.
Key takeaways
- Dataset documentation should cover purpose, composition, creation, quality, limitations, operations, governance, and maintenance — the five families that Gebru's datasheet and Microsoft's Aether template arrive at independently.
- Narrative claims are strongest when linked to contracts, profiles, lineage, access policy, incidents, and reproducible evidence. BookCorpus's documented 11,038 books became 7,185 unique books the first time anyone recounted them.
- Documentation, use approval, and ongoing monitoring are connected but distinct governance functions, and they fail in different ways.
- A completed datasheet increases transparency but does not certify compliance, quality, or fitness for every use. On Hugging Face, only 30.9% of 24,065 dataset repositories had a non-empty card, and 'Considerations for Using the Data' took 2.1% of the text on the most-downloaded ones.
- Use reviews should compare decision context, population, rights, evidence, and consequence before setting conditions, as UK Biobank's Access Subcommittee does with a two-tier scrutiny rule and a material transfer agreement.
- Deprecation and retirement require consumer migration, access changes, evidence retention, and propagation to derived artifacts. MS-Celeb-1M survived its April 2019 retraction through 8 derivative datasets and 21 model repositories, and the FTC's Everalbum order made trained models deletable artifacts.