Page Comments & AI Reviewer

Your team can now talk through changes right where they happen: leave a comment on any text or block in the editor or in a branch review, mention a teammate, and resolve the thread when it's handled. Joining those threads is the AI Reviewer. Request a review and it reads every page your branch touches, checks it against your Linter rules, and leaves what it finds as comments you can fix in place.

New Features

Editor

  • Page comments are now available in the editor on Pro plans and above. Select text and click Comment, or use the ≡ menu next to any block, then @ mention teammates and resolve threads when they're done. The Comments panel in the right rail lists every thread on the page, filtered by Open, Outdated, and Resolved. Comments aren't committed to git and readers never see them. Enterprise Group Admins can choose which roles can leave or resolve comments from the Projects table. Read the announcement.
  • Reviews have a new Overview tab with an AI summary of the branch's changes, an Activity feed of the review and its comment threads, plus the branch's contributors and each reviewer's status.
  • Teammates, Viewers included, can comment in a review on text or a block in the diff, or on the whole branch from the Overview. Comments on a branch also show in Edit mode on that branch.
  • Enterprise Branch Rules add No Blocking Comments, which holds a merge until blocking comments from selected roles or the AI Reviewer are resolved. Reviewer Approval can now count the AI Reviewer's approval, and Dismiss Stale Approvals requires re-approval after the branch changes.

Reviews

  • [Beta] The AI Reviewer checks every page a branch changes against your Linter Error and Warning rules when you request a review, and leaves each finding as a comment on the text it applies to, including problems a change causes elsewhere on the page. Click Fix on a comment, or Fix All on the review, to send findings to the Agent. Available on Pro plans and above.

AI Writer

  • The Slack AI Writer and the GitHub AI Writer can now create, update, and delete Recipes on their draft branches.
  • Comments from the GitHub AI Writer now include a Re-run documentation update link once the PR has new commits. A re-run updates the existing draft branch, keeping any edits made to it in ReadMe.

Translations

  • Enterprise groups can now translate from a source language other than English. Use Change Source Language on the source language's pane in the Translations page. The previous source language stays on as a language to translate into.

Docs

  • Custom JS can now listen for lifecycle events on your docs site: user:ready, route:changed, content:rendered, modal:open, modal:close, search:open, and search:close. content:rendered fires on every page type once its content has rendered.

Improvements

Ask AI

Docs

  • Response fields in the API Reference now have anchor links, so you can link directly to one and find it through search.
  • An endpoint page's "Updated" date now changes when an OpenAPI update changes that endpoint, whether the update comes from the dashboard, the API Designer, rdme, or your linked repository.

Git Sync

  • When a branch changes files ReadMe doesn’t manage (like CI config in your linked repository), the merge modal now lists them, and Merge Anyway merges them along with your docs.

Translations

  • The Translations page labels AI languages, remembers the language you picked across a refresh, and shows “Version missing” with a one-project Retranslate when a project’s language version has been deleted.
  • The API Explorer’s generated header descriptions and the Allowed: label on enum parameters are now translated on translated projects.
Fixes

Editor

  • The [ page link menu in the editor and the Custom Page picker in Site Navigation now list every Custom Page.
  • Typing an HTML comment around bold, linked, or other formatted text in the editor now comments it out, and it stays hidden after saving.
  • After a branch merge, Git sync, or AI Agent edit, the editor shows the page's updated description and other page fields, including during multiplayer editing.
  • Creating or renaming a branch with a name that isn't allowed now explains what to change, such as two special characters in a row or a name that overlaps an existing branch.

Reviews

  • Fix All in the Linter and Docs Audit now leaves out style guide rules that already score 10/10.

Docs

  • Inline code in Recipe navigation descriptions stays readable when the docs site is in light mode.
  • Social preview images now render for projects without a logo, or with a logo that can’t be drawn.

API Reference

Git Sync

  • The Suggest Edit link now shows on docs pages opened in a new tab or refreshed, and is hidden once the linked repository goes private.
  • Branches created through Git sync now show up on Branches right away.
  • Branch previews on the docs site now show the branch rather than the stable version.
  • Merges and rebases that would leave an API definition with invalid JSON or YAML are now stopped before anything is saved.

Enterprise

  • The Weekly Review Digest now reaches group admins, editors, and viewers for branches in the group's child projects.