Skip to content

References: Verb Vocabulary Design and the ADL Verb Registry

<<<<<<< HEAD 1. Controlled Vocabulary - Wikipedia - General principles of controlled vocabulary design, with examples from library science that illuminate why xAPI deliberately doesn't enforce a fixed verb list.

  1. Internationalized Resource Identifier (IRI) - Wikipedia - The identifier scheme that makes verbs portable. Understanding IRI semantics is essential for designing custom verbs that won't collide with anyone else's.

  2. Linked Data - Wikipedia - Background on the dereferencable-URL design philosophy that xAPI inherits — why a verb IRI ideally resolves to a definition document, and what happens when it doesn't.

  3. xAPI: An Introduction - Megan Bowe & ADL contributors - Advanced Distributed Learning - Chapters on verb selection cover the trade-offs between canonical and custom verbs with case studies from real adoption efforts.

  4. The xAPI Companion - Megan Bowe & Aaron Silvers - HT2 Labs - Includes a verb-design decision framework: when to reuse, when to extend, and when a new verb is genuinely needed — with examples of common over-customization mistakes.

  5. ADL Verb Registry - Rustici Software / ADL - Browse-and-search interface to the canonical ADL verbs plus community-submitted verbs, with usage statistics and example statements for each.

  6. xAPI Vocabulary on xapi.com - Rustici Software - Practitioner-friendly index of well-known verb categories (interactive, social, mobile, simulation) with guidance on which to prefer for each use case.

  7. xAPI Profiles Specification - ADL Net - The mechanism for publishing a custom vocabulary as a JSON-LD profile, including the metadata fields every verb definition should carry.

  8. DCMI Metadata Terms - Dublin Core Metadata Initiative - Reference for the metadata vocabulary (title, description, creator, etc.) that profile servers reuse when documenting custom verbs.

10. W3C JSON-LD Best Practices - World Wide Web Consortium - Authoritative guidance on JSON-LD context design, useful when authoring profile documents that must remain interpretable years after publication.

  1. Controlled Vocabulary - Wikipedia - Foundational article on why curated vocabularies (versus free-text tags) are the prerequisite for cross-system analytics. Maps directly onto why xAPI verbs must be IRIs from a known registry.

  2. Resource Description Framework - Wikipedia - RDF's subject-predicate-object triple is the conceptual ancestor of xAPI's actor-verb-object. Reading this clarifies why xAPI verbs are IRIs and why semantic interoperability is achievable.

  3. Semantic Versioning - Wikipedia - The major.minor.patch model that vocabulary profile maintainers must apply when evolving custom verb sets without breaking existing analytics queries.

  4. Designing Data-Intensive Applications - Martin Kleppmann - O'Reilly Media - Chapters on schema evolution and forward/backward compatibility translate directly to vocabulary design — what happens when one team's attempted becomes another team's tried.

  5. Learning Analytics: From Research to Practice (2nd Edition) - Larusson and White (Editors) - Springer - Multiple chapters discuss the consequences of inconsistent verb vocabularies on cohort comparison, the analytics problem this chapter is teaching readers to prevent.

  6. ADL Verb Vocabulary Registry - ADL / Tin Can - The canonical registry of community-vetted verbs, complete with definitions, related activity types, and example usage. The reference this chapter teaches readers to consult before inventing anything.

  7. ADL xAPI Verbs - ADL Initiative - The original ADL-published verb namespace (http://adlnet.gov/expapi/verbs/...) that includes experienced, attempted, passed, completed, failed, and other foundational verbs.

  8. xAPI Profile Server - ADL Initiative - The official server hosting community xAPI profiles, including verb concepts, activity types, and Statement Templates. Where a custom verb profile ultimately gets published.

  9. cmi5 Specification — Defined Verbs - AICC / ADL - Worked example of a constrained vocabulary profile: cmi5 defines exactly nine verbs for LMS-launched content. A model for how to draw a tight vocabulary boundary.

  10. xAPI.com — Choosing Verbs - Rustici Software - Practical advice on selecting verbs that maximize cross-platform analytics value, including the real-world cost of vocabulary fragmentation.

    d2ecc9b (iframe updates)