Skip to content

Generated Scenes

A generated Practice Set scene can do more than provide visual context.

It can resolve scene state and share that same state with generated questions and answers.

This allows the visual environment and the practice content to agree.

A generated Practice Set can combine:

[scene:clock]
[questions:clock-time]
[question-mode:random]

These instructions have separate responsibilities.

scene identifies the scene.

questions identifies the question set that can use the scene state.

question-mode controls how that generated practice is resolved.

Suppose a Clock scene resolves to:

8:15

The displayed clock shows that time.

The question system receives the same resolved state and can generate:

¿Qué hora es?

with a corresponding answer:

Son las ocho y cuarto.

The scene and answer therefore describe the same generated time.

This shared state is the central idea behind generated Practice Set scenes.

For example:

[id:clock-practice]
[cat:time, clock]
[scene:clock]
[questions:clock-time]
[question-mode:random]

Kx can materialize random scene state and generate applicable practice from that state.

Generated Practice Set scenes can also use:

[question-mode:static]

Static mode uses the scene’s static state and resolves the applicable question set.

static is the default question mode.

Generated Practice Sets Without Authored Lines

Section titled “Generated Practice Sets Without Authored Lines”

A generated Practice Set may contain no authored practice lines when its scene and question set generate them.

For example:

[id:clock-generated-practice]
[cat:clock, time]
[scene:clock]
[questions:clock-time]
[question-mode:random]

This Practice Set acts as a recipe for generating practice rather than as a collection of prewritten lines.

A normal Practice Set that does not generate its lines should still contain authored practice content.

Calendar can use the same model:

[id:calendar-practice]
[cat:date, calendar]
[scene:calendar]
[questions:calendar-date]
[question-mode:random]

A resolved Calendar scene contains a year, month, and day.

The question system can use that same state to generate:

¿Cuál es la fecha?

with a corresponding answer based on the resolved date.

Do not confuse:

[question-mode:random]

with:

fscene:office.random

They solve different problems.

question-mode:random participates in Practice Set-level generated state. Questions and answers can be generated from that same state.

.random on fscene: or bscene: independently randomizes a card-face scene. It does not automatically make authored questions or answers depend on the resulting scene state.

Use generated Practice Set scenes when coordinated state matters.

Use random line scenes when the visual itself may vary independently.

Kx Markdown v0.2.0