Skip to content

Glossary

This glossary defines key terms used throughout the Experience Notation documentation.


Adaptation

A narrative or behavioural description of how a persona may change over the course of a journey. Optional within a Persona: block.

Conditional

A branching block used within a Step: that describes alternate outcomes depending on a stated condition, using IF, THEN, and ELSE fields.

EBNF (Extended Backus–Naur Form)

A formal notation used to describe the syntax rules of Experience Notation. Used to guide both human authors and automated validation.

Event

A major unit of experience within a journey, composed of one or more sequential Step: blocks.

Experience

A freeform emotional or contextual description of a persona’s state at the beginning of the journey.

External-Source

A URL reference to an external resource or document relevant to the journey context.

Journey

A top-level .expn file representing a structured user experience, composed of metadata, personas, and one or more events.

Metrics

Quantitative or qualitative persona state values (e.g. mood=low, energy=medium). Used to enrich simulation or roleplay.

Persona

A named user or agent defined in the .expn file. Includes Traits:, Experience:, Metrics:, and optionally Adaptation:.

Step

An individual action taken within an Event:. Includes subfields such as User:, Action:, UI-Element:, and optionally Conditional:.

Tag

A keyword or category assigned to a Step: to support indexing, classification, or filtering.

Traits

Key–value pairs that define behavioural or demographic characteristics of a persona.

UI-Element

The interface component or system element that the persona interacts with in a given step.

User

The name of the persona involved in a given Step:.


If you're looking for syntax specifics, see the EBNF Grammar or JSON Schema Reference.