docs: scrub Insert/Replace from docs to match shipped UI (#618)

* docs: scrub Insert/Replace from docs to match shipped UI

The annotation toolbar ships with Delete, Comment, Quick label (⚡),
Looks good (👍), and Copy. AnnotationType only has DELETION, COMMENT,
and GLOBAL_COMMENT. Insertion/Replacement were removed in #400 but
several docs still describe them as toolbar options.

Updates 9 files (the 7 listed in #617 plus two additional pages with
the same drift):

- apps/marketing/src/content/docs/getting-started/quickstart.md
- apps/marketing/src/content/docs/getting-started/ui-settings.md
- apps/marketing/src/content/docs/commands/plan-review.md
- apps/marketing/src/content/docs/commands/annotate.md
- apps/marketing/src/content/docs/commands/code-review.md
- apps/marketing/src/content/blog/welcome.md
- apps/marketing/src/content/blog/plannotator-meets-pi.md
- apps/marketing/src/content/blog/sharing-plans-with-your-team.md
- apps/portal/ANNOTATE.md

Where it made sense, added a note that users can ask for replacements
or insertions inside a Comment — the agent handles it during revision.

Closes #617

* docs: include Looks good (👍) in toolbar enumerations

Author: vxio

apps/marketing/src/content/blog/plannotator-meets-pi.md

@@ -49,7 +49,7 @@ Because the plan lives on disk as a regular file, you can open it in your editor
 
 ### Review phase
 
-When the agent calls `plannotator_submit_plan`, the extension reads `PLAN.md` from disk, starts a local HTTP server, and opens the Plannotator browser UI. You see the rendered plan with all the annotation tools — comments, deletions, replacements, insertions.
+When the agent calls `plannotator_submit_plan`, the extension reads `PLAN.md` from disk, starts a local HTTP server, and opens the Plannotator browser UI. You see the rendered plan with all the annotation tools — comments, deletions, global comments, quick labels, and "looks good" approvals.
 
 Three outcomes:
 

apps/marketing/src/content/blog/sharing-plans-with-your-team.md

@@ -37,9 +37,9 @@ You paste this in Slack and send it to your senior teammate.
 Your senior clicks the link. The share portal — a static page with no backend — decompresses the URL hash and renders the plan with your annotations. They can now add their own feedback:
 
 - **Comment** on the migration script section: "Add a rollback step"
-- **Replace** the session handling approach: swap JWT for HTTP-only cookies
+- **Comment** on the session handling approach: "Swap JWT for HTTP-only cookies"
 - **Delete** the unnecessary logging middleware
-- **Insert** a note about rate limiting on the new auth endpoints
+- **Quick label** the auth endpoints with "Needs tests" and add a comment: "Document rate limiting here"
 
 Each annotation is tied to the specific text it references.
 
@@ -49,7 +49,7 @@ Your senior clicks **Export → Copy Link** to share their annotated version bac
 
 ### 5. You send combined feedback to Claude
 
-With the merged annotations in front of you, you click **Request Changes**. Plannotator formats the combined feedback — deletions, replacements, comments, insertions — into structured markdown and sends it back to Claude Code through the hook system. Claude receives specific, actionable feedback and revises the plan.
+With the merged annotations in front of you, you click **Request Changes**. Plannotator formats the combined feedback — deletions, comments, global comments, quick labels, and "looks good" approvals — into structured markdown and sends it back to Claude Code through the hook system. Claude receives specific, actionable feedback and revises the plan.
 
 ## How the hook integration works
 

apps/marketing/src/content/blog/welcome.md

@@ -14,7 +14,7 @@ Plannotator is a plan review UI for Claude Code that intercepts `ExitPlanMode` v
 
 ## What is Plannotator?
 
-When Claude Code generates a plan, Plannotator opens an interactive review UI in your browser. You can read through the plan, select text to annotate, and provide structured feedback — deletions, replacements, comments, and insertions — before approving or requesting changes.
+When Claude Code generates a plan, Plannotator opens an interactive review UI in your browser. You can read through the plan, select text to annotate, and provide structured feedback — deletions, comments, global comments, quick labels, and "looks good" approvals — before approving or requesting changes.
 
 ## Key Features
 

apps/marketing/src/content/docs/commands/annotate.md

@@ -99,7 +99,7 @@ The annotation UI in annotate mode works the same as plan review, with a few cha
 - `Cmd/Ctrl+Enter` sends annotations instead of approving
 - The completion screen says "Annotations Sent" instead of "Plan Approved"
 
-All annotation types work identically: deletions, replacements, comments, insertions, global comments, and image attachments.
+All annotation types work identically: deletions, comments, global comments, quick labels, "looks good" approvals, and image attachments.
 
 ## Flags
 

apps/marketing/src/content/docs/commands/code-review.md

@@ -79,7 +79,7 @@ The review UI shows your changes in a familiar diff format:
 - **File tree sidebar** for navigating between changed files
 - **Viewed tracking** to mark files as reviewed and track your progress
 - **Unified diff** showing additions and deletions in context
-- **Annotation tools** with the same annotation types as plan review (delete, replace, comment, insert)
+- **Annotation tools** with the same annotation types as plan review (delete, comment, quick label, "looks good")
 
 ## Annotating code
 

apps/marketing/src/content/docs/commands/plan-review.md

@@ -36,11 +36,13 @@ When you select text in the plan, the annotation toolbar appears with these opti
 | Type | What it does | Example |
 |------|-------------|---------|
 | **Deletion** | Marks text for removal | "Remove this section" |
-| **Replacement** | Suggests alternative text | "Change `WebSocket` to `SSE`" |
 | **Comment** | Adds feedback on a section | "This needs error handling" |
-| **Insertion** | Adds content after the selection | "Add a retry mechanism here" |
+| **Quick label** | Applies a preset label (⚡) | "Clarify this", "Needs tests", "Out of scope" |
+| **Looks good** | Marks a section as approved (👍) | — |
 | **Global comment** | General feedback (not tied to text) | "The plan looks good overall but needs tests" |
 
+If you want a replacement or an insertion, ask for it in a comment ("Change `WebSocket` to `SSE`" or "Add a retry mechanism here") — the agent will incorporate it during the revision.
+
 ## Image attachments
 
 You can paste or upload images and attach them to annotations. Images are given human-readable names (e.g., "login-mockup") and referenced in the exported feedback. This is useful for sharing mockups, screenshots, or diagrams alongside your annotations.

apps/marketing/src/content/docs/getting-started/quickstart.md

@@ -31,12 +31,15 @@ The plan renders as formatted markdown with syntax-highlighted code blocks. Read
 Select any text in the plan to open the annotation toolbar. Choose an action:
 
 - **Delete** — Mark text for removal ("Remove this")
-- **Replace** — Suggest replacement text ("Change this to...")
 - **Comment** — Add feedback on a section ("This needs more detail")
-- **Insert** — Add new content after the selection ("Add error handling here")
+- **Quick label** (⚡) — Apply a preset label like "Clarify this", "Needs tests", or "Out of scope"
+- **Looks good** (👍) — Mark a section as approved
+- **Copy** — Copy the selected text to your clipboard
 
 You can also add **global comments** — general feedback that isn't tied to specific text.
 
+Need a replacement or an insertion? Just say so in a comment — the agent will handle it.
+
 Switch between annotation modes using the mode switcher at the top of the document:
 
 - **Select** — Click to select text, then choose an annotation type

apps/marketing/src/content/docs/getting-started/ui-settings.md

@@ -116,7 +116,7 @@ The mode switcher below the header in the plan review UI controls how text selec
 
 | Mode | Behavior |
 |------|----------|
-| **Selection** (default) | Select text, then choose an annotation type from the toolbar (comment, deletion, replacement, insertion) |
+| **Selection** (default) | Select text, then choose an annotation type from the toolbar (comment, deletion, quick label, "looks good") |
 | **Comment** | Select text to immediately create a comment annotation |
 | **Redline** | Select text to immediately create a deletion annotation |
 

apps/portal/ANNOTATE.md

@@ -74,10 +74,10 @@ The annotation tools are identical to plan review:
 Annotation types:
 
 - **Deletion** — "Remove this"
-- **Replacement** — "Change this to..."
 - **Comment** — "Feedback on this..."
-- **Insertion** — "Add this after..."
 - **Global comment** — General feedback not tied to specific text
+- **Quick label** — Apply a preset label like "Clarify this" or "Needs tests"
+- **Looks good** — Mark a section as approved (👍)
 
 Users can also paste or upload images and attach them to annotations.