Why oral histories require special care
Unlike a photograph or a document, an oral history record contains a living person’s account of personal experience. The narrator has given something of themselves. Several things follow from that:- The narrator’s consent must be obtained before the record is archived, and the scope of that consent must be respected in the access level you set.
- The narrator is a creator, not a subject. Their name and role must appear in the
creatorarray. - The language the narrator spoke in must be recorded — it is part of the record’s authenticity.
- The context of the interview — who was present, when it happened, what the narrator chose to share — belongs in the description.
Oral history documentation workflow
Obtain and record consent
Before the interview, discuss with the narrator how the recording will be used, who will have access to it, and under what conditions. Agree on an access level (
public, restricted, or community-only) and document the consent.Conduct the interview and note the context
Record who conducted the interview, where it took place, and the date. Note whether it was conducted in the narrator’s first language or a second language. These details go into the description and the
creator array.Initialize the record
Run
dms init to create a new record with a UUID. Set type to story for oral history narratives, or audio if the primary item is the recording itself.List both participants as creators
The narrator and the interviewer are both creators. List them with accurate roles:
Set the language field
Set
If the interview was conducted in two languages, record the primary language.
language to the language spoken in the interview — not the language of any translation or transcription. Use IETF BCP 47 codes.| Code | Language |
|---|---|
en | English |
sw | Swahili |
fr | French |
rw | Kinyarwanda |
ki | Kirundi |
ln | Lingala |
so | Somali |
ny | Chichewa |
Set the format field
The
If both a transcription and an audio recording exist as separate items, create two records and link them using the
format field specifies the MIME type of the digital object being described.| Item | format value |
|---|---|
| Transcription (plain text) | text/plain |
| Transcription (PDF) | application/pdf |
| Audio recording (MP3) | audio/mpeg |
| Audio recording (WAV) | audio/wav |
| Audio recording (OGG) | audio/ogg |
relation field.Write a contextual description
The description should preserve the interview context. Include:
- What the narrator chose to share
- The circumstances or occasion of the interview
- Themes the account addresses
- The original event date and location, if known
Set access level as agreed with the narrator
Use the access level the narrator consented to. Do not upgrade access later without re-obtaining consent.
Example: a well-documented oral history record
The following is the completestory.json example from the DMS repository. It demonstrates every field described above.
What this record does well
Both participants are credited as creators
Both participants are credited as creators
Marie Consolée is listed with
role: narrator — not as a subject, not as a contributor, but as a creator. Jean-Baptiste Mushimiyimana is listed as interviewer with his institutional affiliation. The rights.holder is set to the narrator, because the account is hers.The description preserves interview context
The description preserves interview context
The description names the narrator’s origin (Bukavu), the destination (Dzaleka), the year (2015), and the themes (resilience, loss, rebuilding). Someone encountering this record with no prior knowledge of Dzaleka can understand what it contains and why it matters.
event_date vs. created are distinct
event_date vs. created are distinct
date.created (2024-03-15) is when the metadata record was written. date.event_date (2015-08-22) is when the original journey took place. These are separate fields for a reason — the archive date and the historical date must not be conflated.source documents provenance
source documents provenance
The
source object records that this was originally an audio interview that was later transcribed, contributed by the Dzaleka Digital Heritage Project, and filed in the Oral Histories 2024 collection. This provenance chain is essential for future researchers.coverage captures the historical period
coverage captures the historical period
The
coverage object gives the temporal scope of the content itself — the year 2015 — separate from the date the record was created. The human-readable period field (2015 displacement and arrival) aids browsing and search.