Writing Content
Version 1.2.0
The practical, day-to-day version of editing — what a Writer actually does, tool by tool.
The basic loop
Ask for what you want: "write a post about X," "fix the second paragraph," "publish the draft." Every edit starts a draft on its own branch, so nothing you're working on can collide with anyone else's in-progress edit on the same entry. Publishing merges that branch through a real, reviewable pull request and makes it live.
You never have to think about git directly to use this. Every action becomes a real commit behind the scenes, but the interface is a conversation, not a terminal.
What an entry actually holds
Title, date, and body are the basics. Blog posts also carry a pillar — which content cluster the post belongs to, a real editorial decision rather than something guessed — and tags, for finer-grained, cross-cutting labels. Docs pages carry a section (which sidebar group) and an order (position within it) instead.
What you can write
Content is a small, explicit set of safe HTML — not arbitrary markup. Before writing anything unusual, check the current allowed vocabulary rather than guessing: the full list of tags, attributes, and components lives in the Style Guide Reference and the components reference, both generated live from the same rules that actually enforce them. A request that isn't in the allowlist gets rejected outright — not silently stripped — so what you see in a draft is what will actually ship.
Images
Attach an image by URL, by pasting a small image directly, or through a dedicated upload page for anything larger, like a real photo. Whichever way it comes in, the site generates the properly-sized, modern-format versions it actually serves — that part never needs thinking about separately.
Publishing, review, and mistakes
Publish directly, or open it for review first if a second person should look before it goes live — both are real, separate actions. If something's wrong after the fact, undoing a publish or restoring a deleted entry are both real, callable actions too, not a trip through backups. Nothing is ever actually gone.