Skip to content

Main content

African Oral History Speaker Credit Tool

Render a caller-approved oral-history speaker credit only when the explicit public-credit consent flag is set.

Loading tool…

Description

Format the preferred credit or speaker credit withheld.

Cultural and community records can carry access, attribution, quotation, and publication permissions. Preserving a supplied label does not create permission or override community protocols, source conditions, or an individual's stated preferences.

Format the preferred credit or speaker credit withheld.

When to use this tool

Use African Oral History Speaker Credit when you need to record a supplied attribution or access statement without expanding its scope.

How to use the tool and how it works

  1. Enter preferredCredit, recordingId, publicCreditConsent. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read credit. Use the output convention below.

Require nonempty recordingId and preferredCredit when publicCreditConsent. Format the preferred credit or speaker credit withheld.1

Input fieldMeaning and unitsAccepted input
preferredCreditPreferred CreditRequired. Text; maximum UTF-16 length 8192.
recordingIdRecording IdRequired. Text; maximum UTF-16 length 8192.
publicCreditConsentPublic Credit ConsentRequired. Boolean.
Output fieldInterpretationReturned shape
creditCreditRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "preferredCredit": "Speaker A",
    "recordingId": "REC17",
    "publicCreditConsent": true
  },
  "output": {
    "credit": "REC17 — Speaker A"
  }
}

Limitations and assumptions

  • The supplied flag does not verify informed consent, speaker identity, current permission, community protocols, or rights to reuse the recording.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.

Alternative or Complementary methods

Confirm the original permission, community protocol, and intended use with the responsible people before sharing material.

References

  1. Calculation and input contract: african-studies/african-oral-history-speaker-credit — tool.io

Similar or alternative tools