Enterprise Analytics

Enterprise projects have a new cross-project dashboard for their documentation metrics, surfacing traffic and engagement data across every child project in one place.

New Features & Improvements

Editor

  • Reusable content and custom components now confirm before you lose unsaved changes or delete content, have a dedicated Visual/Raw mode toggle, and show clearer usage counts and marketplace browsing.
  • The editor now has a panel for adding markdown blocks, reusable content, and custom components straight into your docs.
  • Custom pages can now support custom components.

Docs

  • Search now matches API reference pages by their path, not just their title or content.

Analytics

  • Grouping filters in metrics charts now tint to match their series color and default to showing the 12 busiest groups, up from 5.

CLI

  • rdme openapi upload now shows which ReadMe project your API key is targeting, in the overwrite confirmation prompt, success message, --dry-run output, and still-processing message.

AI

  • AI Writer now sends its own notification when it opens a docs pull request for review, linking to the GitHub PR, with the branch's ready-by attribution showing correctly.

Bugs Eaten (by Owlbert) 🐛

API Reference

  • Certain reused schema references in an API definition no longer cause uploads to fail, and requests now correctly match operations with hyphenated path parameters or server URLs containing periods.
  • Clearing all content from an API reference page now leaves it fully empty, instead of showing a stray blank gap between sections.

Editor

  • Fixed several editing issues with Tabs, Cards, and Columns: pressing Enter on a blank line no longer splits the component apart, and pasting into the first tab now lands inside that tab with the cursor staying put.
  • The link dialog now accepts relative URLs starting with ./ or ../, so you can link between pages without hardcoding your project slug.
  • The AI content generator no longer renders underneath reusable content blocks, and opening it now automatically closes the Blocks Panel so they don't compete for space.
  • Removing a Recipe through the AI Agent now fully deletes it, instead of leaving behind a broken, content-less page.
  • Merging a branch while a page is open in the collaborative editor now shows the merged content immediately instead of stale pre-merge content, and collaborator cursor colors no longer collide between two users.
  • Components like tabs, callouts, cards, and tables inside an inline AI edit now render correctly in the diff preview, instead of leaving a blank gap.

Docs

  • Fixed two redirect bugs: custom redirect rules for a docs URL are now respected even when a reference page exists at the same slug, and requesting the markdown version of a project's homepage now redirects to the markdown version of its first page instead of falling back to HTML.
  • Collapsed FAQ and accordion blocks now print their full content in PDF exports, and pages using MDX-only syntax no longer silently drop from the export.

Admin

  • The notification preferences project picker now renders with a solid background in Firefox, and the inbox popover fits within narrow screens instead of overflowing.
  • Enterprise admins can now fully clear their Teammates and End User Login domain safelists, instead of cleared domains reappearing after a refresh.
  • Settings pages for integrations now stack properly on narrow screens, instead of cutting off connect buttons.
  • AI Discovery no longer appears in group settings for legacy enterprise groups whose child projects don't support it.

Git Sync

  • Git sync connection setup is more reliable: initial syncs that partially fail are now reported instead of showing a false success message, GitLab webhook verification no longer errors for enterprise sub-projects, and the Bitbucket connection page advances automatically once a repository is linked.
  • Branches created and deleted in quick succession are no longer lost, whether deleted right back out after being recreated or left out of sync entirely.
  • Pages synced via Git sync are no longer incorrectly flagged as invalid MDX for projects using ReadMe's standard Markdown engine.
  • For enterprise groups sharing a parent's GitLab connection, a child project's Git sync now recovers automatically after an auth failure, instead of staying broken until the next scheduled token refresh.