Skip to content

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

Merged
backnotprop merged 2 commits intobacknotprop:mainfrom
vxio:docs/remove-insert-replace
Apr 27, 2026
Merged

docs: scrub Insert/Replace from docs to match shipped UI#618
backnotprop merged 2 commits intobacknotprop:mainfrom
vxio:docs/remove-insert-replace

Conversation

@vxio
Copy link
Copy Markdown
Contributor

@vxio vxio commented Apr 27, 2026

Closes #617.

Since the removal of INSERTION and REPLACEMENT was intentional. This PR scrubs both from the docs and brings the toolbar inventory in line with the shipped UI: Delete, Comment, Quick Label (⚡), Looks good (👍), Global Comment, Copy.

Updates the 7 files from the issue, plus 2 more I noticed had the same drift while sweeping:

  • apps/marketing/src/content/docs/commands/code-review.md — toolbar inventory listed (delete, replace, comment, insert)
  • apps/marketing/src/content/blog/sharing-plans-with-your-team.md — example bullets and closing paragraph used Replace/Insert

Where the original passage was instructional, I added a short note that users can ask for a replacement or insertion inside a Comment — preserves the capability without misrepresenting the UI.

vxio added 2 commits April 26, 2026 22:53
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 backnotprop#400 but
several docs still describe them as toolbar options.

Updates 9 files (the 7 listed in backnotprop#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 backnotprop#617
@backnotprop
Copy link
Copy Markdown
Owner

Thank you 🙏

@backnotprop backnotprop merged commit 9a32022 into backnotprop:main Apr 27, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs reference Insertion/Replacement capabilities, but they don't exist in the UI

2 participants