Teaching & Commentary

Teaching notes must be separate from liturgical text. This lets OLS serve Sunday school, youth group, catechesis, and adult formation without altering the service itself.

{
  "teaching": {
    "summary": {
      "en": "This prayer asks for mercy before approaching the altar."
    },
    "bibleLinks": ["Heb.4.16", "Ps.50.1"],
    "ageLevel": "youth"
  }
}

Attach Without Altering

Teaching content should reference the liturgical entity it explains. A worship view can omit teaching notes; a study view can place them beside the same source text without modifying it.

Use summary for a concise explanation, bibleLinks for canonical references, and ageLevel to help applications choose an appropriate presentation. If separate youth and adult explanations are needed, create separately addressable notes rather than combining audiences in one paragraph.

Commentary should identify its author and source when it makes historical, theological, or linguistic claims. An explanatory note inherits neither the authority nor the license of the liturgical text it discusses.