Review a site with comments

§ 1Purpose

Run the click-to-comment review loop: a reviewer pins notes on the served site, and the notes are listed, worked through, and resolved from the CLI.

§ 2Prerequisites

• A wdoc document that builds cleanly
• A wcl CLI on your PATH

§ 3Flowchart

§ 4Steps

$ wcl wdoc serve site.wcl --comment
Serving on http://127.0.0.1:8080

Start the dev server with --comment to inject the review client into every page. The comments live in a comments.wcl sidecar beside the document — writing one never triggers a rebuild.

In the browser, click the block the note is about and type the comment. Repeat on any page of the site; everything lands in the comments.wcl sidecar.

$ wcl wdoc comments .
$ wcl wdoc comments . resolve <id>

Run wcl wdoc comments to list every open note with its id, page, and text. Work through them, then resolve <id> marks a note done and drops it from the open list.

$ wcl wdoc review site.wcl
waiting for the reviewer…

An agent working the loop runs wcl wdoc review instead: it blocks until the reviewer clicks "Send to agent" in the comment toolbar, then prints the round's comments exactly like comments. Re-running it re-shows the toolbar banner for the next round.