docs(admin): a page for the message-template editor #22

wtclaude · 2026-08-29T23:15:51Z

wtclaude commented

2026-08-29 23:15:51 +00:00

The operator half of engagement Phase 5b, which ENGAGEMENT.md §6.0b assigns to this repo. Pairs with RunicGateway/website#173 and RunicGateway/docs#186.

A new Administration → Message templates page, placed after Notifications and email (which covers configuring the transport; this covers what the messages say).

It explains, for someone running a site rather than someone reading the design document:

what the list holds, and why the system ones are editable but not deletable;
that your edits survive upgrades — a later shipped default is not applied over your words, it is offered;
that the body is blocks, not HTML, and why;
that variables are clicked, never typed, and why the save refuses one the message is not given (it would render as nothing, so the mistake would be invisible until it reached an inbox);
the two halves of every message and when to override the plain-text one;
draft vs published — a draft is not what goes out, the shipped default is;
the preview, including what the dark-mode control is approximating and why it is worth a glance;
test sends, which send what is on screen whether or not it is saved;
duplicating to make a new template, and why a key cannot be changed later;
the send log, and that it keeps a one-way fingerprint rather than anybody's address.

No version numbers anywhere in it. checkFacts reads each fact's authority from the source repo's main, and none of Phase 5b is there until the cutover — so the page describes behaviour and names no number that would go stale or turn this repo red early.

All ten checks green: links, sidebar, a11y, csp, reference, facts, brand, tokens, quickstart, datasafety. Added to both the sidebar and the plannedSidebar drift list. Rendered and read in a browser.

AI-assisted: written with Claude Code (Claude Opus 5)

🤖 Generated with Claude Code

https://claude.ai/code/session_01T6t8mrAWhZU5vnyYgZTMtL

The operator half of engagement Phase 5b, which `ENGAGEMENT.md` §6.0b assigns to this repo. Pairs with RunicGateway/website#173 and RunicGateway/docs#186. A new **Administration → Message templates** page, placed after *Notifications and email* (which covers configuring the transport; this covers what the messages say). It explains, for someone running a site rather than someone reading the design document: - what the list holds, and why the **system** ones are editable but not deletable; - that **your edits survive upgrades** — a later shipped default is not applied over your words, it is offered; - that the body is **blocks, not HTML**, and why; - that **variables are clicked, never typed**, and why the save refuses one the message is not given (it would render as *nothing*, so the mistake would be invisible until it reached an inbox); - the two halves of every message and when to override the plain-text one; - **draft vs published** — a draft is not what goes out, the shipped default is; - the preview, including what the dark-mode control is approximating and why it is worth a glance; - **test sends**, which send what is on screen whether or not it is saved; - **duplicating** to make a new template, and why a key cannot be changed later; - the **send log**, and that it keeps a one-way fingerprint rather than anybody's address. **No version numbers anywhere in it.** `checkFacts` reads each fact's authority from the source repo's `main`, and none of Phase 5b is there until the cutover — so the page describes behaviour and names no number that would go stale or turn this repo red early. All ten checks green: links, sidebar, a11y, csp, reference, facts, brand, tokens, quickstart, datasafety. Added to both the sidebar and the `plannedSidebar` drift list. Rendered and read in a browser. --- - [x] AI-assisted: written with Claude Code (Claude Opus 5) 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01T6t8mrAWhZU5vnyYgZTMtL

wtclaude added 1 commit 2026-08-29 23:15:52 +00:00

docs(admin): a page for the message-template editor 289b6b3a8d

The operator half of engagement Phase 5b, which 6.0b of ENGAGEMENT.md assigns to
this repo: what the Templates screen is for, how a shipped default is edited in
place without an upgrade taking the edit back, why variables are clicked rather
than typed, the two halves of every message, draft vs published, the preview and
its dark-mode approximation, test sends, duplicating to make a new template, and
the send log.

Written for someone running a site, not someone reading the design document: it
explains what to do and why the refusals exist, and names no version numbers - the
facts check reads authority from each repo's `main`, and none of this is there yet.

Co-Authored-By: Claude <noreply@anthropic.com>

whitlocktech merged commit ebd6ba8dbf into edge

2026-08-29 23:37:09 +00:00

whitlocktech referenced this issue from a commit

2026-08-29 23:37:09 +00:00

Merge pull request 'docs(admin): a page for the message-template editor' (#22) from docs/engagement-template-editor into edge

whitlocktech deleted branch docs/engagement-template-editor

2026-08-29 23:37:10 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: RunicGateway/runicgateway.com#22