Field notes on docs, AI, and the web

How great teams actually ship docs.

Long-form writing on documentation, AI-readable content, the editor we wish existed, and the change-management problem nobody talks about.

— Latest

Recent writing

Two More Editor Blocks: Columns and Frame
● doklyOct 12, 2026

Two More Editor Blocks: Columns and Frame

Dokly's editor can now lay content side by side and set a screenshot or diagram apart from the surrounding prose. Both render live in the same editor you already write in — here's what shipped.

Your agent can now move pages and switch your site's layout
● Product UpdatesOct 11, 2026

Your agent can now move pages and switch your site's layout

This week your connected AI agent stopped being limited to editing content. It can rearrange your sidebar, switch your site between docs and help-center layout, and post a changelog entry — all from the terminal.

Two New Blocks in the Editor: Mermaid Diagrams and Accordions
● doklyOct 10, 2026

Two New Blocks in the Editor: Mermaid Diagrams and Accordions

Dokly's editor can now render Mermaid diagrams from plain text and collapse long sections into accordions — both live in the same editor you already write in. Here's what shipped and what it still can't do.

Review your agent's docs edits without leaving the terminal
● Product UpdatesOct 7, 2026

Review your agent's docs edits without leaving the terminal

Dokly's MCP server now lets you list, approve, or reject an agent's pending page changes as tool calls — no trip to the dashboard required. Here's how review actually works, end to end.

Quarry and Meadow: Two Docs Themes Built for Different Jobs
● doklyOct 6, 2026

Quarry and Meadow: Two Docs Themes Built for Different Jobs

Dokly now ships eight documentation themes instead of six. The two new ones, Quarry and Meadow, are the first real test of whether our theming engine can produce structurally different products — not just different colors.

We Moved Support to Discord
● doklyOct 5, 2026

We Moved Support to Discord

Dokly's primary support channel is now Discord, not an email ticket queue. Here's what changed on the contact page, the pricing page, and inside the dashboard — and why public answers beat private ones.

Start for free

Ready to ship better docs?

Join developers who chose simplicity over enterprise pricing. Instant setup, no git required.

Get started free
Blog - Dokly | Documentation Tips, Tutorials & Best Practices