[jung-thomas]

Closes sap-tutorials/tutorials-ims#2819.

Public-catalog mirror of sap-tutorials/meta-tutorials-Contribution#13.

Adds a new meta tutorial teaching authors the tutorial variables feature shipped in tutorials-ims#2818 (implements tutorials-ims#2811): the variables: frontmatter block and {{var:NAME}} body tokens that let a reader type a per-person value once and have it substituted live into prose, inline code, and copy-pasteable fenced code blocks.

Slug: use-variables-in-tutorials

What it covers

• Why variables exist (the manual-XXX-everywhere problem) and when not to use one
• Declaring a variables: block — every field and the hard-fail validation rules
• Referencing {{var:<name>}} in prose, inline code, and fenced code blocks
• The optional default: { from, pattern } identity-regex pre-fill (allowlist: email, id, givenName, familyName)
• Client-side persistence + mission carry-over semantics (by variable name)
• A pre-publish verification checklist

Self-demonstrating

Declares one real variable, groupNumber, and uses {{var:groupNumber}} throughout prose, inline code, and a bash block — the reader sees their own value substituted live while learning the feature.

Validation

Ran through the actual composeTutorial parser (the real build path): accepts cleanly, 7 steps, 1 variable parsed with correct schema, 0 unwrapped live tokens; the 6 literal {{var:<name>}} occurrences are intentional syntax examples (non-matching metavariable). Single H1, 7 H3 steps, <!-- description --> present, LF line endings.

🤖 Generated with Claude Code

[sap-tutorials-builder]

Content (1)

• tutorials/use-variables-in-tutorials/use-variables-in-tutorials.md:1 — No step headings found (expected at least one '## ' heading that is not 'You will learn' or 'Prerequisites')

Checked e08e3fc • notify-only, does not block merge

[jung-thomas]

Canonical authoring/QA source PR: sap-tutorials/meta-tutorials-Contribution#13