Skip to content

score-interpretation-list.md

Latest commit

 

History

History
426 lines (327 loc) · 10.8 KB

score-interpretation-list.md

File metadata and controls

426 lines (327 loc) · 10.8 KB

Score Interpretation List

A Score Interpretation List is a collection of score interpretations that imply order via their naming or required proficiencies.

Required content

  • Name - A namespace to associate the topics. Case insensitive. No special characters.
  • Description - A brief description of the knowledge domain covered by this topic list.
  • Version - Any indicator to unique identify the version of the list.
  • Issuer - The owner of this topic list.
  • Issued At - The time when the list was created and assigned a version number.
  • Certificate - Verification from the issuer that the list is unmodified.
  • Score Interpretations - A dictionary of score interpretation objects.
  • Dependencies - A list of URIs to required topic lists.

Signed

If distributed, the list is signed by the issuer with each release of a version to enable verification.

Distributable

Unlike topic lists, an interpretation list only needs to be distributed to required consumers.

  • Enables both standard public definitions and private internal-only definitions.
  • It is served to the audience with minimal restriction.

This enables:

  • Shared interpretation by multiple parties
  • Discourages conflicting definitions.
  • Combining different interpretations.

Examples

Simple Progression - Arithmetic

The below example shows a simple example where only competent requirements are specified.

flowchart BT

subgraph Topics
  addition[/addition\]
  subtraction[/subtraction\]

  multiplication[/multiplication\]
  division[/division\]

  exponents[/exponents\]
  roots[/roots\]
end

subgraph Score Interpretations
  arithmetic-level-1{{"Arithmetic<br/>✨ Level 1"}}
  arithmetic-level-2{{"Arithmetic<br/>✨ Level 2"}}
  arithmetic-level-3{{"Arithmetic<br/>✨ Level 3"}}
end

%% Mapping
addition -.competent.-x arithmetic-level-1
subtraction -.competent.-x arithmetic-level-1

multiplication -.competent.-x arithmetic-level-2
division -.competent.-x arithmetic-level-2

exponents -.competent.-x arithmetic-level-3
roots -.competent.-x arithmetic-level-3
Loading
Show YAML 
owner: example.com
name: math-levels
description: Mathematics Proficiency Levels
version: 0.1.0
issued-at: 2026-01-26T01:00:00Z
certificate: -----BEGIN CERTIFICATE-----ABC123DEF456-----END CERTIFICATE-----

score-interpretations:
  arithmetic-1:
    name: Arithmetic - Level 1
    description: Practical experience with addition and subtraction.
    requirements:
      math.addition: competent
      math.subtraction: competent

  arithmetic-2:
    name: Arithmetic - Level 2
    description: Practical experience with multiplication and division.
    requirements:
      math.multiplication: competent
      math.division: competent

  arithmetic-3:
    name: Arithmetic - Level 3
    description: Practical experience with multiplication and division.
    requirements:
      math.exponents: competent
      math.roots: competent

dependencies:
  math: https://example.com/0.1.0/math.json

Information

Guided Progression - Arithmetic

The below example shows requiring familiar scores in topics before actually practicing them in the next level where they then gain competent scores.

flowchart BT

subgraph Topics
  addition[/addition\]
  subtraction[/subtraction\]

  multiplication[/multiplication\]
  division[/division\]

  exponents[/exponents\]
  roots[/roots\]
end

  subgraph Score Interpretations
    arithmetic-level-1{{"Arithmetic<br/>✨ Level 1"}}
    arithmetic-level-2{{"Arithmetic<br/>✨ Level 2"}}
    arithmetic-level-3{{"Arithmetic<br/>✨ Level 3"}}
  end

%% Mapping
addition -.competent.-x arithmetic-level-1
subtraction -.competent.-x arithmetic-level-1
multiplication -.familiar.-x arithmetic-level-1
division -.familiar.-x arithmetic-level-1

multiplication -.competent.-x arithmetic-level-2
division -.competent.-x arithmetic-level-2
exponents -.aware.-x arithmetic-level-2
roots -.aware.-x arithmetic-level-2

exponents -.competent.-x arithmetic-level-3
roots -.competent.-x arithmetic-level-3
Loading
Show YAML 
owner: example.com
name: math-levels
description: Mathematics Proficiency Levels
version: 0.1.0
issued-at: 2026-01-26T01:00:00Z
certificate: -----BEGIN CERTIFICATE-----ABC123DEF456-----END CERTIFICATE-----

score-interpretations:
  arithmetic-1:
    name: Arithmetic - Level 1
    description: Practical experience with addition and subtraction. Prepared to start Arithmeetic - Level 2.
    requirements:
      math.addition: competent
      math.subtraction: competent
      # Prepare for next level
      math.multiplication: familiar
      math.division: familiar

  arithmetic-2:
    name: Arithmetic - Level 2
    description: Practical experience with multiplication and division. Prepared to start Arithmeetic - Level 3.
    requirements:
      math.multiplication: competent
      math.division: competent
      # Prepare for next level
      math.exponents: aware
      math.roots: aware

  arithmetic-3:
    name: Arithmetic - Level 3
    description: Practical experience with multiplication and division.
    requirements:
      math.exponents: competent
      math.roots: competent

dependencies:
  math: https://example.com/0.1.0/math.json

Job Roles - Math Teacher

Below is an example of defining internal requirements for "Math Teacher" job roles for a school.

  flowchart BT

  subgraph Topics
    basic-math[/basic-math\]
    classroom-management[/classroom-management\]

    lesson-planning[/lesson-planning\]
    lesson-customization[/lesson-customization\]

    teacher-mentoring[/teacher-mentoring\]
    curriculum-development[/curriculum-development\]
  end

  subgraph Score Interpretations
    direction BT
    math-teacher-junior{{"Junior<br/>Math Teacher"}}
    math-teacher{{"Math Teacher"}}
    math-teacher-senior{{"Senior<br/>Math Teacher"}}
  end

  %% Dependencies
  subgraph dependencies
    std-math@{ shape: docs, label: "std-math<br/>example.com/0.1.0/math.json" }
    std-pedagogy@{ shape: docs, label: "std-pedagogy<br/>example.com/0.1.0/pedagogy.json" }
  end

  %% Mapping
  std-math -.- basic-math -.competent.-x math-teacher-junior
  std-pedagogy -.- classroom-management -.competent.-x math-teacher-junior

  std-pedagogy -.- lesson-planning -.competent.-x math-teacher
  std-pedagogy -.- lesson-customization -.competent.-x math-teacher

  std-pedagogy -.- teacher-mentoring -.competent.-x math-teacher-senior
  std-pedagogy -.- curriculum-development -.competent.-x math-teacher-senior
Loading
Show YAML 
owner: example.com
name: math-teacher-levels
description: Internal definition of math teacher proficiency.
version: "0.1.0"
issued-at: "2026-01-26T01:00:00Z",
certificate: "-----BEGIN CERTIFICATE-----ABC123DEF456-----END CERTIFICATE-----",

score-interpretations:
  math-teacher-junior:
    name: JR. Math Teacher
    description: Able to support another teacher with all content.
    requirements:
      std-math.basic-math: comptent
      std-pedagogy.classroom-management: competent

  math-teacher:
    name: Math Teacher
    description: Able to teach a classroom alone.
    requirements:
      std-pedagogy.lesson-planning: competent
      std-pedagogy.lesson-customization: competent

  math-teacher-senior:
    name: Sr. Math Teacher
    description: Actively building course curriculum and supporting other staff.
    requirements:
      std-pedagogy.teacher-mentoring: comptent
      std-pedagogy.curriculum-development: comptent

dependencies:
  std-math: "https://example.com/topics-lists/0.1.0/math.json"
  std-pedagogy: "https://example.com/topics-lists/0.1.0/pedagogy.json"

Badges - Gold/Silver/Bronze

Below is an interpretation of math scores to award bronze/silver/gold badges.

flowchart BT

subgraph Topics
  addition[/addition\]
  subtraction[/subtraction\]

  multiplication[/multiplication\]
  division[/division\]

  exponents[/exponents\]
  roots[/roots\]
end

subgraph Score Interpretations
  1-bronze{{"🥉<br/>Bronze"}}
  2-silver{{"🥈<br/>Silver"}}
  3-gold{{"🥇<br/>Gold"}}
end

%% Mapping
addition -.competent.-x 1-bronze
subtraction -.competent.-x 1-bronze

multiplication -.competent.-x 2-silver
division -.competent.-x 2-silver

exponents -.competent.-x 3-gold
roots -.competent.-x 3-gold
Loading
Show YAML 
owner: example.com
name: math-badges
description: Mathematics badges themed metals.
version: 0.1.0
issued-at: 2026-01-26T01:00:00Z
certificate: -----BEGIN CERTIFICATE-----ABC123DEF456-----END CERTIFICATE-----

score-interpretations:
  1-bronze:
    name: Bronze
    description: Numbers and what they can do.
    requirements:
      math.addition: competent
      math.subtraction: competent

  2-silver:
    name: Silver
    description: Mastery of the basics.
    requirements:
      math.multiplication: competent
      math.division: competent

  3-gold:
    name: Gold
    description: The best of the best!
    requirements:
      math.exponents: competent
      math.roots: competent

dependencies:
  math: https://example.com/0.1.0/math.json

Badges - Magic

Below is an interpretation of math scores into playful badges in the real of magic.

flowchart BT

subgraph Topics
  addition[/addition\]
  subtraction[/subtraction\]

  multiplication[/multiplication\]
  division[/division\]

  exponents[/exponents\]
  roots[/roots\]
end

subgraph Score Interpretations
  1-acolyte{{"🪄<br/>Acolyte"}}
  2-wizard{{"🧙<br/>Wizard"}}
  3-sage{{"🧝<br/>Sage"}}
end

%% Mapping
addition -.competent.-x 1-acolyte
subtraction -.competent.-x 1-acolyte

multiplication -.competent.-x 2-wizard
division -.competent.-x 2-wizard

exponents -.competent.-x 3-sage
roots -.competent.-x 3-sage
Loading
Show YAML 
owner: example.com
name: math-badges-magic
description: Mathematics badges themed in the world of magic and spells.
version: 0.1.0
issued-at: 2026-01-26T01:00:00Z
certificate: -----BEGIN CERTIFICATE-----ABC123DEF456-----END CERTIFICATE-----

score-interpretations:
  1-acolyte:
    name: Acolyte
    description: Numbers and the magic they contain.
    requirements:
      math.addition: competent
      math.subtraction: competent

  2-wizard:
    name: Wizard
    description: The powers of quanity and manipulation.
    requirements:
      math.multiplication: competent
      math.division: competent

  3-sage:
    name: Sage
    description: A wizard of numerical calculation!
    requirements:
      math.exponents: competent
      math.roots: competent

dependencies:
  math: https://example.com/0.1.0/math.json