Ship a design doc through review

turtwig

You wrote a design doc with Claude. It looks great as HTML. Now you need feedback from three colleagues, an LGTM from your tech lead, and a version that survives the trip into a PR description. Here's the loop.

§01

Paste the HTML, get a URL

On the home page, paste the doc's HTML or upload a .html file. Set the visibility to link if you only want the people you share the URL with to see it.

The doc gets a slug, a viewer at /d/<slug>, and a parallel Markdown review view that lives at the same URL with ?view=review. The rich HTML is for visual review; the Markdown is for "does it read right."

§02

Share the URL with reviewers

Send the link. Reviewers don't need an account to read a link-visibility doc, but they do need to sign in to comment — one magic-link email round-trip, no password.

Once they're in, selecting any text in the HTML opens an anchored comment in the right gutter. Multi-paragraph selections work. They see exactly the slice of the doc they're reacting to.

§03

Discuss in threads, resolve as you go

Replies thread one level deep. Either the doc owner or the comment author can resolve. Resolved cards stay in the gutter at 50% opacity (or you can hide them with the toggle in the gutter header) so the conversation is auditable.

You get an email when someone new comments on your doc, with the author, the anchored snippet, and a deep link. No notification settings beyond "owner gets the email."

§04

Address comments with Claude

When a comment is genuinely actionable ("clarify this paragraph," "add a section on rollback"), click Address with Claude on the card. duodoc sends the current HTML plus the comment to Claude with a prompt that asks for a surgical edit, returns the proposed v2 in a sandboxed iframe preview, and waits for you to Accept or Discard.

Accepted edits become a real new version of the doc with the comment auto-resolved. You see a diff view at /d/<slug>/diff/1/2 — line-level by default, side-by-side toggle, word-level highlights inside changed lines, unchanged context collapsible.

§05

Ship the doc, take the Markdown with you

Open the download menu in the viewer header:

  • .html — the standalone artifact, no duodoc scripts attached. Drop it in a PR description.
  • .md — the clean Markdown extraction (turns out most things travel best as Markdown).
  • .zip — both files plus every open comment as a sidecar Markdown file. Useful if you want to keep the review thread alongside the doc in Notion / Confluence.