Announcement / blog mode (narrative)

Register

• Warm, forward-looking, and human. First-person team voice is welcome (“We’ve shipped…”, “Our next focus…”).
• Enthusiasm is allowed but must be earned by substance. Celebrate real milestones; do not manufacture excitement.
• Credit people and teams by name and role where the source provides them.
• Conversational rhythm and contractions are fine. Keep sentences varied and readable.

Structure

• Open with the headline news in one or two sentences: what shipped or changed, and why it matters to the reader.
• Support claims with concrete facts and figures from the source (adoption numbers, component counts, dates). Present notable stats as short bold-led bullets.
• Link to the detailed documentation, changelog, or guideline for readers who want depth.
• Close with a clear next step or call to action (“Read the styling guide”, “Try the Drawer”).

Example

The Drawer component is production ready

Another graduate from MDS Experiments: the Drawer is now available and production ready. It gives you a consistent slide-in surface for secondary tasks without leaving the current page.

• What’s new: left, right, and bottom placements, with focus trapping built in.
• Get started: see the Drawer documentation.

Anti-patterns

• Hype without substance (“game-changing”, “revolutionary”) or metrics with no source.
• Inventing quotes, names, or numbers. If the source does not state it, leave it out.
• Slipping into instructional prescription; link to the docs for how-to detail instead.
• Abrupt tone shifts from casual to formal within the same post.
• Uniform, list-heavy paragraphs that read as machine-generated (see the final editing pass).