Iroko Historical Society · Iroko Framework v2.0.0

Documentation

Technical guides, usage instructions, and contribution guidelines for the Iroko Framework

v2.0.0 February 2026 View on GitHub ↗

Guides

Developers Contributing Guide Vocabulary development & maintenance

Complete guide to setting up your development environment, editing vocabularies, validating changes, and deploying updates. For vocabulary maintainers and developers contributing to the Iroko Framework.

  • Development setup (Python, dependencies)
  • Editing vocabulary files (TTL syntax)
  • Validation and testing
  • HTML generation from RDF
  • Deployment workflow
  • Pull request guidelines
Adopters Vocabulary Reuse Guide Institutions adopting the Iroko Framework

How archives, museums, universities, and cultural institutions can adopt the Iroko Framework vocabularies. Explains how to apply the vocabulary with institution-specific access policies and provides integration patterns.

  • Understanding vocabulary structure
  • Choosing your access policy approach
  • Integration with existing systems
  • RDF/TTL usage examples
  • SPARQL query patterns
  • Darwin Core & SKOS interoperability
Architecture Technical Architecture System design & infrastructure

Deep dive into the technical architecture of the Iroko Framework. Covers the separation between vocabulary definitions and operational data, URI strategies, deployment infrastructure, and the relationship between the vocabulary repository and operational archive.

  • System architecture overview
  • Vocabulary vs. data separation
  • URI permanence strategy
  • Access control implementation
  • Export and synchronization workflows
  • Technology stack details

Getting Started

Using the vocabulary
Start with the Vocabulary Reuse Guide for adoption patterns, access policy examples, and integration with your existing systems.
Contributing
Start with the Contributing Guide for development setup, TTL editing conventions, and the pull request workflow.
Technical design
Start with Technical Architecture for URI strategies, vocabulary/data separation, and deployment infrastructure.
Browsing vocabularies
Go directly to Vocabulary Documentation to browse all published modules, classes, properties, and concept schemes.

About the Iroko Framework

The Iroko Framework provides semantic vocabularies for governing access to sacred knowledge in Afro-Atlantic traditions. It enables institutions to document cultural heritage while maintaining community control over sensitive information through field-level access governance.

All vocabularies serialize to RDF/Turtle and integrate with Darwin Core, Dublin Core, PROV-O, FOAF, and schema.org.

  • Postcustodial Approach — Communities retain authority; the archive serves the tradition, not the institution
  • Field-Level Access Control — Six-tier permissions applied per property, not per record
  • Standards-Aligned — W3C RDF/OWL/SKOS, Linked Open Data best practices
  • Semantic Interoperability — Integrates Darwin Core, SKOS, PROV-O, FOAF, schema.org

Project Links

License

All Iroko Framework vocabularies are released under CC0 1.0 Universal (Public Domain). You are free to use, adapt, and redistribute without restriction.