🐛 Bugs Eaten (by Owlbert):

  • Editor: Fixed an issue where generating the page description with AI was failing
  • Auth: Fixed an issue where projects couldn’t be switched from SAML back to using a ReadMe login
  • Versions: Fixed an issue where projects with a large number of versions couldn’t unpublish them
  • Versions: Fixed an issue where certain versions weren’t appearing in the project dashboard
  • Recipes: Fixed an issue where Recipes didn’t have the correct meta tags
  • API Reference: Fixed an issue where $refs that were null crashed the page
  • API Reference: Fixed an issue with deleting an object field from the manual API editor
  • PDF Generation: Fixed an issue where nested content wasn’t included in the generated PDF
  • Docs: Updates to our icon library

Improvements:

  • SSO: Added OpenID Connect as an option for end users
  • Developer Dashboard: My Requests can now show Try It requests while logged out
  • Developer Dashboard: Opening an expired shared request now loads the page with expiration info in the response
  • Developer Dashboard: Added x-documentation-url header info to response details
  • Global Landing Page: If a description is not provided, we now use the project description for improved SEO
  • API Reference: Added webhook icon to the sidebar to make it easier to tell which endpoints are webhooks
  • Editor: Improved support for writing longer descriptions

🐛 Bugs Eaten (by Owlbert):

  • Search: Fixed an issue where project name letter casing was not being updated
  • Developer Dashboard: Fixed an issue with a non-loading graph in My Requests
  • Developer Dashboard: Fixed an issue where request history wasn’t being preserved when server variables are changed
  • Developer Dashboard: Fixed an issue where Slack notifications weren’t working or displaying the correct icons
  • Doc Metrics: Fixed an issue where the graphs would not load
  • Navigation: Fixed an issue where the dropdown navigation menu would briefly display the incorrect page
  • Navigation: Fixed an issue where adding a ? to the URL on Changelog and Reference pages would prevent the page from loading
  • SSO: Fixed an issue where group mappings could stop working
  • Global Landing Page: Improved performance by removing an unnecessary redirect
  • Owlbot AI: Fixed an issue where CSV exports would be formatted incorrectly
  • Manual Editor: Fixed an issue where creating new pages would fail
  • PDF Export: Fixed an issue where PDFs weren’t being generated sometimes
  • API Reference: Fixed an issue where enum objects with default values were selected, even when defaults were not enabled
  • Editor: Fixed an issue where errors would be shown on embeds URLs before a URL is entered
  • Editor: Fixed an error when saving Reusable Content
  • Enterprise: Fixed an issue where project passwords were not editable from the Group dashboard
screenshot of API Gateway instructions

Setting up your Developer Dashboard with AWS API Gateway is easier than before. Get API keys in your docs and understand your API customers, by setting up within your AWS Console. Find the new setup steps from your Admin Dashboard → My Developers → Set Up API Keys and select the API Gateway tab.

Improvements:

  • Landing Page: Added support for OpenGraph images
  • API Reference: minLength and maxLength are now better surfaced in the UI
  • SSO: SAML verification codes are now easier to spot in your emails
  • Custom Domains: Some projects will see a new custom domains setup page

🐛 Bugs Eaten (by Owlbert):

  • SSO: Fixed an issue with an empty safelist and authentication errors
  • Editor: Fixed an issue where JSX comments would cause the page to crash
  • Editor: Fixed an issue where back-to-back Reusable Content blocks could fail to render
  • Editor: Fixed an issue where files could be mixed up on upload
  • API Reference: Fixed an issue where base URLs in the request code is not persisted on refresh
  • API Reference: Fixed a recent regression where parameter inputs weren’t reset between endpoint pages
  • Suggested Edits: Fixed an issue where non-merged Suggested Edits would update the last updated timestamp
  • Inviting Users: Fixed an issue where inviting users could sometimes fail
  • Docs: Fixed an issue where you couldn’t navigate to a parent page if it was an endpoint

We've made improvements to Enterprise Staging when promoting your changes to production to make it clearer which changes will be going live. We now show a breakdown of who made changes and which sections are affected.

Improvements:

  • Developer Dashboard: When viewing an API Log, the list of headers is now collapsible.
  • Developer Dashboard: Add an error rate chart that shows what percentage of requests errored across all of your developers.

🐛 Bugs Eaten (by Owlbert):

  • Editor: Fixed the issue where the Reusable Content menu was preventing writing HTML in the editor.
  • API Reference: Fixed the issue where a schema object property being set to null caused the page to crash.
  • API Reference: Fixed the issue where optional objects with required properties were incorrectly being displayed as required objects.
  • API Reference: Fixed the issue preventing switching an endpoint page back to a normal page in the dashboard.
  • Reusable Content: Fixed the issue where Reusable Content blocks with special characters in their name couldn’t be deleted.
  • Discussions: Fixed the issue preventing users from completing reCAPTCHA verification for suspected spam.
  • Quick Switcher: Fixed the issue navigating to Guides and API References via the dashboard quick switcher.
  • SEO: Fixed some admin routes not being disallowed in robots.txt.
  • Search: Fixed links to reference pages returned via the search API endpoint.

Improvements:

  • Auth: Allow end users to request access from the protected page screen

🐛 Bugs Eaten (by Owlbert):

  • SEO: Improve UX for generating an SEO description with AI
  • SEO: Fixed blank title tags in some server-rendered HTML
  • Recipes: Fixed layout issue with Recipes endpoint picker
  • Recipes: Fixed issue where Recipe code overlapped with line numbers on initial load
  • Signup: Fixed issue where validation errors during signup prevented progressing
  • API Reference: Fixed issue causing default values for enums to be displayed twice
  • API Reference: Fixed issues for callbacks with additionalProperties displaying incorrectly

Improvements

  • API Reference: More descriptive variable name in api code samples
  • API Reference: Display min/max values for parameters more prominently
  • API Reference: Improved styling of parameter objects with multiple levels of nesting
  • Guides: Strip style tags when generating metadata for SEO
  • Project Dashboard: Make searching for users by email case insensitive
  • Developer Dashboard: Improved Demo experience if project doesn’t have any recent API logs

🐛 Bugs Eaten (by Owlbert):

  • Auth: Fixed issue where updating end user SSO configuration incorrectly modified redirect URI
  • Guides: Fixed issue where pages with empty HTML blocks caused page to error
  • Variables: Fixed issue where variables were sometimes being saved in correctly in the editor
  • API Reference: Fixed issue where certain Try It responses would cause page to error
  • API Reference: Polymorphic objects with custom keywords will render correctly

Improvements

  • Billing: Added billing details UI, so you can see the total amount of your invoices, next payment, and more!
  • Favicons: We now convert SVG icons for broader browser support on upload
  • API Explorer: Parameter inputs are now hidden when custom code samples are defined in your OAS file
  • SDK: Generated SDK code is a little more personal

🐛 Bugs Eaten (by Owlbert):

  • Recipes: Fixed an issue where users couldn’t remove emojis from a Recipe
  • Billing: Fixed an issue where trial project navigation wasn’t working
  • Billing: Fixed an issue where the next invoice would show the incorrect date
  • Billing: Fixed an issue where add-on UI would show costs to the 4th decimal
  • Developer Dashboard: Fixed an issue where the spend breakdown would show the incorrect amount
  • API Explorer: Fixed an issue where authentication was not persisting across projects with the same domain
  • Dashboard: Fixed an issue with SVG uploads not working
  • Navigation: Fixed an issue with custom links not properly navigating users
  • Integrations: Updated Google Analytics copy for clarity

Over the past few weeks, we've rolled out improvements to our billing flow, including annual billing and supporting additional ways to pay. Customers who switch to one of the new annual plans will receive a discount on the monthly rate. In addition to paying via credit card, we now support payments via ACH as well as cards that require Enhanced Multi-Factor Authentication (MFA).

Improvements

  • Recipes: Added class names for components in Recipes for use with Custom CSS
  • Security: Warning when deleting a project with a custom domain to remove CNAME in DNS provider

🐛 Bugs Eaten (by Owlbert):

  • Recipes: Fixed menu overflow for projects with a lot of API Endpoints
  • Recipes: Fixed error that occurred when reordering specific Recipes
  • API Reference: Fixed setting the browser page title when navigating within the reference section
  • API Reference: Fixed bug with redirect not persisting from the "Authenticate" button on the API Getting Started page
  • API Reference: Fixed issue where certain browsers were missing styles in select components
  • Discussion: Show suspected spam posts a captcha to prevent false positives
  • Documentation: Fixed issue where the table of contents would be shown after navigating even when disabled
  • Documentation: Fixed issue where non-teammates were able to view hidden versions
  • Search: Fixed issue where project filters in search weren’t showing up until after a search was started
  • Staging: Fixed issue where Group Viewers logged in via SAML were unable to view staging
  • Editor: Fixed issue where focus was being lost when adding embedded content
ReadMe UI with emoji autocomplete

We’ve switched over to native system emoji set for a more consistent experience. Emojis in our editor and recipes were previously using a different set of characters (native unicode and Twemoji). And now we also support even more emoji (Emoji 14.0), and aliases to make it easier to find emoji when searching.

Improvements

  • Owlbot AI: Now using GPT-4o; for faster responses
  • Admin Dashboard: Manage Plan page now shows upcoming plan changes
  • Search: Minor improvements to search network performance
  • PDF Export: Customers on the Business tier can now export PDFs

🐛 Bugs Eaten (by Owlbert):

  • Editor: Fixed an issue where duplicate dividers were shown in the API Reference editor
  • Editor: Fixed an issue where duplicating synced endpoint pages would fail
  • Editor: Fixed an issue where menus weren’t accessible on active pages
  • API Reference: enums formatted as int32 now renders as a select element instead of text input
  • API Reference: Fixed a regression with menu sizes for the language selector
  • API Reference: Fixed an issue where optional parameter values were being set with the default handling option was enabled
  • Search: Fixed an issue where long titles in search were not completely visible
  • Changelog: Fixed an issue where variables weren’t being rendered in RSS feeds
  • Recipes: Fixed an issue where emojis weren’t being displayed
  • Enterprise: Fixed an issue where the global landing page would crash with Owlbot and private projects
  • Custom CSS: Fixed an issue where .rm-Header-bottom wasn’t applying to the correct element
  • Custom CSS: Added .rm-SearchModal-empty classes for easier customization of search UI

Over the past few weeks, we’ve been working on new options to customize your API References. As we've added more options we decided the page to set that up needed a refresh! Go to Appearance → API Reference to see the settings:

  • Show Request History UI to view past Try It and actual API requests
  • Automatically populate parameter inputs with default values
  • Edit the request body with JSON
  • Expand response schemas by default
  • Expand the first 200 response example by default
  • Make use of ReadMe’s SDK generator for code examples in 20 languages

Improvements

  • Search/Reusable Content: Content on a page from a Reusable Content block will now be indexed by search
  • API Reference: Add a toggle to mask or show API Key

🐛 Bugs Eaten (by Owlbert):

  • Search: Don’t show empty pages in search results
  • a11y: Better maintain screen reader location when closing the search modal
  • Editor Sidebar: UI Improvements for spacing and consistency while editing Category titles
  • Editor: Fix list items being unnecessarily escaped from within headers
  • Transfer Ownership: Fix transferring ownership on projects without active plans
  • API Reference: Fix situations where the browser back button wouldn't take you to the correct page
  • API Reference: Fixes for generated Swift code samples
  • API Reference: Fix the height of request code samples being too small on pages with long responses
  • API Reference: More even spacing between parameter sections
  • API: Fix body_html response in the Get Doc endpoint being returned as Markdown
  • UI: Fix some icons in buttons appearing too close to the button label
  • Staging: Fix links to preview suggested edits while on staging
  • Staging: More reliably clear cache on staging promotion