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

dokly
● doklyOct 21, 2026

Panel: A Block That Renders Somewhere Else

Dokly's editor now has a block whose content doesn't stay where you write it — it replaces the table of contents in the page's side rail instead. Here's what it does, what it needs to work, and what happens when there's no rail to move it into.

dokly
● doklyOct 19, 2026

Tooltip: A Hover Note Without Breaking the Sentence

Dokly's editor now has an inline tooltip — dotted-underline text that reveals a short note on hover or keyboard focus. Here's what it does and what it leaves out.

Product Updates
● Product UpdatesOct 18, 2026

Six new blocks this week, and your editor crossed 20 components

This week's editor update adds a file-tree diagram and catches up the week's component builds — Frame, Update, Columns, ParamField, ResponseField, and Icon — in one place.

dokly
● doklyOct 17, 2026

Two New Blocks for Documenting an API: ParamField and ResponseField

Dokly's editor can now document a request parameter or a response field as its own row, with a type, a required flag, and a description — the shape every API reference page needs. Here's what shipped, demoed against Dokly's own MCP tools.

dokly
● doklyOct 16, 2026

The Smallest New Editor Block Yet: Icon

Dokly's editor now has an inline icon you can drop into a sentence — for calling out a specific UI element without a screenshot. Here's what it does and what it deliberately leaves out.

A Fifth Editor Block: Update, for Hand-Written Changelogs
● doklyOct 14, 2026

A Fifth Editor Block: Update, for Hand-Written Changelogs

Dokly's editor now has a block for writing a changelog or release-notes page by hand in MDX — each entry gets its own linkable heading. Here's what it does, and how it's different from Dokly's own changelog feature.

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