6. Review, edit, and keep it current

The maintenance loop: browser editing, the human⇄agent review handshake, and source-driven updates.

After this lesson you can

- Edit units from the rendered book with serve --edit - Run the comment/review loop between a reviewer and an agent - Use source blocks to drive update sweeps

Before you start: Ship the AI skill

A wskill is alive: wcl wdoc serve --edit --comment gives you in-browser editing (every unit page has an Edit button that opens the exact object) and click-to-comment review. An agent runs wcl wdoc review . to wait for a reviewer's send, then works through the comments and resolves them by id.

source blocks record where authoritative information lives and when it was last checked — an update sweep walks them, refreshes what drifted, and bumps topic.version.

§ 1Exercise: Run one review round

Serve with --comment, pin a comment on any page, list it from the CLI, then resolve it.

bash
wcl wdoc serve wdoc/book/main.wcl --comment &
# click a block in the browser, leave a note, then:
wcl wdoc comments . --format json
wcl wdoc comments . resolve <id>

Expected result

The comment appears in the JSON list with a page and locator, and disappears after resolve.