🚧

This is a Staged Rollout!

We're rolling out this new experience to current Enterprise customers over the next few weeks to ensure a smooth transition. You'll get an Intercom notification in your dashboard when the functionality is live for your group. If you have any questions don't hesitate to reach out directly to your Product Experience Manager!

Making sure all of your team members and customers have the permissions to properly access your ReadMe docs? That's a... (ahem) major key to success*, folks. 🔑

When it comes to managing your Enterprise Group, there can be a lot of moving parts—multiple projects to oversee, lots of eyes on various parts of your docs, and team members and customers requiring different permission levels depending on how they need to interact with your projects. While we love the idea of you sharing your docs with the world, we want to make that sharing experience one that instills confidence rather than confusion. You’ve put enough energy into making your docs beautiful, personalized, and interactive, let us take care of making sure that you can manage your ReadMe projects and teams with ease.

On that note, over the last year we’ve been tinkering away at making our Enterprise authentication and access management experiences more intuitive, and well, better 😎 We're excited to share that these features are now…lights, camera, actionLIVE for all Enterprise customers! ✨

The Scoop 🍨

First, the sidebar in your Enterprise Group dashboard is looking a little different 🧐 We heard from our Enterprise Group Admins that it’s challenging to manage permission settings, especially when managing multiple projects within an Enterprise Group. We also got feedback that bulk inviting individuals to projects, whether they were technical writers needing to access some but not all project dashboards, or customers who needed hub-side access to private docs, was cumbersome and frustrating at times. So we set out to upgrade all of that.

To make it easier to distinguish between user roles, the former, unified Members page in your dashboard is now two separate sections: (1) Teammates and (2) End Users.

Teammates are members of your team who manage (e.g. write, edit, update) documentation related to your projects. End Users are consumers of your projects’ documentation whom you’d like to grant hub-side only access to.

Teammates and End Users have unique needs, and now we’ve created more distinct user permission settings that better map to how you want your team members and customers to interact with your docs. For both of these new user roles we’ve simplified the login configuration and added increased functionalities around managing login methods, access privileges, and default user permissions. This distinction also allows us to keep building more secure and user-friendly docs for both user functions 👍

For some of our Enterprise Admins, it was a headache to manually manage Read Only and Admin permission levels for dozens of users across dozens of projects. So to allow for easier team and multi-project management at scale, the new End User Management page simplifies the process of bulk inviting users to projects and more clearly delineates what projects End Users have access to.

There’s also a new Projects page that makes it easier for Enterprise Group Admins to manage multiple projects at the group level. In this page you can see what projects are associated with an Enterprise Group, as well as add, remove, and/or make projects public or private.

Ray from our team recorded this live walk-through to highlight the new updates we’ve made 📹

And here’s a li'l breakdown of everything that’s changed:

NEW Features

Improvements + Updates

Teammates Page with new settings:
- What’s it all about: where to configure access and invite users from your team (e.g. your company)
- The Domain Safelist dropdown allows you to set a domain and allow anyone with an email address at that domain to create a ReadMe account
- Login and authentication configurations including SSO dropdown + enforcement settings allowing Enterprise Group Admins to determine how they want Teammates to sign in to ReadMe
- Default permission level settings for new invited Teammates
- A new method for inviting teammates and assigning permission levels, as well as new permission levels to choose from (Group Admin, Group Viewer, Custom)

New End Users pages:
- (1) End User Login page with ability to configure the login method for your private docs (hub-side access)
- (2) End User Management page with ability to see and filter users that have access, and bulk invite new users

Projects Page to manage multiple projects within an Enterprise Group
- The Manage Projects button allows Group Admins to add or remove projects
- See all child projects in one centralized place and set as Public or Private

  • Unified view for user permissions
    - Clearer visibility into users’ roles
    - Ability to filter Teammates by permission level and project access
    - Redesigned UI for seeing private vs. public projects
    - One consolidated UI for configuring hub-side login access

You can read more about this new experience in this overview guide. We hope you’re excited for these updates! We’d love to hear from you, whether to share your feedback, ask a question, or just say hello. Feel free to click the Intercom widget to leave a message or send a note to [email protected] :owlbert:

*What's a long-form piece of content on authentication without a DJ Khaled reference?

Hello and welcome to our first full week of March, friends! This week, we're shipping v7.0.0 of rdme, syntax highlighting support for an additional language, and an owl fact. More below! 🚀

👍

We've been rolling out a redesigned docs experience for some time now—check out this page for the details!

The legacy docs style is now deprecated and is not receiving any bug fixes. All changes below are only applicable to the new docs experience (unless otherwise noted). We'll communicate a sunset timeline to any remaining legacy customers soon.

✨ New & Improved

🛠 Fixes & Updates

Hope you're staying safe and healthy! Thanks for being a part of the ReadMe community, folks.

—Kanad and the ReadMe team :owlbert:

📘

What is the Owlet Weekly Update?

Thanks for tuning in to another edition of our Owlet Weekly Update—an owlet-sized update (posted every week to the ReadMe Changelog) on the product updates we're shipping here at ReadMe. We'd love to hear what you think of these updates at [email protected]!

Hello and welcome to another weekly update! We're making headway on some big projects and making some big improvements to our GitHub Actions support. Details below! 🐙

👍

We've been rolling out a redesigned docs experience for some time now—check out this page for the details!

The legacy docs style is now deprecated and is not receiving any bug fixes. All changes below are only applicable to the new docs experience (unless otherwise noted). We'll communicate a sunset timeline to any remaining legacy customers soon.

✨ New & Improved

  • We’ve added first-class GitHub Actions support to our good friend rdme: ReadMe’s official CLI (and as of this week, GitHub Action)! You can sync OpenAPI definitions, you can perform pre-upload OpenAPI validation, and even sync directories of Markdown files—all within an automated GitHub workflow. As part of this, we’ve officially parted ways with our legacy GitHub Action. Check out our new docs page (which, I should add, is synced from the rdme GitHub repo using the rdme GitHub Action) to get the details! 🔄
  • As previously mentioned, we’ve been hard at work re-thinking how Enterprise admins distinguish between user roles and how to simplify the process of managing multiple projects at scale. We’ve made some major improvements and we’ve begun rolling this out to Enterprise projects! This release includes even more work on this front. 👥
  • This release includes even more improvements to our soon-to-be-released editor, which you can get a sneak peek of in our discussion forums! ✍️

🛠 Fixes & Updates

Hope you're staying safe and healthy! Thanks for being a part of the ReadMe community, folks.

—Kanad and the ReadMe team :owlbert:

📘

What is the Owlet Weekly Update?

Thanks for tuning in to another edition of our Owlet Weekly Update—an owlet-sized update (posted every week to the ReadMe Changelog) on the product updates we're shipping here at ReadMe. We'd love to hear what you think of these updates at [email protected]!

Hello and welcome to another weekly update! We had a short week due to a company holiday and we're heads down on a few exciting upcoming projects (stay tuned!), but just know that we finally fixed a bug that I identified the corresponding pop culture reference for weeks ago. More below! 🎤

👍

We've been rolling out a redesigned docs experience for some time now—check out this page for the details!

The legacy docs style is now deprecated and is not receiving any bug fixes. All changes below are only applicable to the new docs experience (unless otherwise noted). We'll communicate a sunset timeline to any remaining legacy customers soon.

✨ New & Improved

  • This release includes even more improvements to our soon-to-be-released editor, which you can get a sneak peek of in our discussion forums! ✍️

🛠 Fixes & Updates

  • Although Damon was completely wrong about Taylor, he probably would have been onto something if he was accusing ReadMe documentation writers of being miscredited for their work... because that was the case, at least for a little bit! For a short period of time, our Page History records were incorrectly always attributing the author of the edits to the person who created the page. While we’re unable to do anything about Mr. Albarn’s Twitter ratio, this release includes a fix so page history going forward should reflect the correct songwri—I mean, author. 🦍

Hope you're staying safe and healthy! Thanks for being a part of the ReadMe community, folks.

—Kanad and the ReadMe team :owlbert:

📘

What is the Owlet Weekly Update?

Thanks for tuning in to another edition of our Owlet Weekly Update—an owlet-sized update (posted every week to the ReadMe Changelog) on the product updates we're shipping here at ReadMe. We'd love to hear what you think of these updates at [email protected]!

Happy Week of Valentines Day, y'all! Seeing as our collective love languages are acts of service and words of affirmation*, this release delivers just that. More below! 💕

👍

We've been rolling out a redesigned docs experience for some time now—check out this page for the details!

The legacy docs style is now deprecated and is not receiving any bug fixes. All changes below are only applicable to the new docs experience (unless otherwise noted). We'll communicate a sunset timeline to any remaining legacy customers soon.

✨ New & Improved

  • As previously mentioned, we’ve been hard at work re-thinking how Enterprise admins distinguish between user roles and how to simplify the process of managing multiple projects at scale. We’ve made some major improvements and we’ve begun rolling this out to Enterprise projects! This release includes even more work on this front. 👥
  • This release adds some much-anticipated endpoints to the ReadMe API: you can now create, edit, and delete categories via our API! It wouldn’t be a ReadMe API announcement without a link to our endpoint docs, so be sure to check those endpoints out here! 🗄️
  • This release includes even more improvements to our soon-to-be-released editor, which you can get a sneak peek of in our discussion forums! ✍️
  • Minor accessibility improvements in the search results, which should make it easier to open results in a new tab. 🔍

🛠 Fixes & Updates

  • We’d like to give a quick shout out to the response sections in the API Reference that refuse to conform to the societal norm of numerically sorting their response codes. 200s, followed by 500s, followed by... 400s?! This is bold and brave stuff, y'all. We see you and we appreciate you! And we fixed an edge case where your response titles were getting a little mixed up. 🔀
  • Fixed a few enterprise-related quirks that caused our Slack integration to not send messages in certain circumstances. 📥
    {/ TODO: figure out if I should mention PDF gen!/}
  • This release fixes some long-standing issues with PDF generation. 📝
  • Fixed a couple quirks with the creation of Recipes. 🧑‍🍳

Hope you're staying safe and healthy! Thanks for being a part of the ReadMe community, folks.

—Kanad and the ReadMe Team :owlbert:

*(and probably all of them, in some capacity)

📘

What is the Owlet Weekly Update?

Thanks for tuning in to another edition of our _Owlet Weekly Update**—an _owlet-sized update (posted every week to the ReadMe Changelog) on the product updates we're shipping here at ReadMe. We'd love to hear what you think of these updates at [email protected]!

Hello and welcome to another Owlet Weekly Update, friends! We have a bit of a lighter release this week, but we continue to build on our mission of ensuring that buttons and links take you to all of the correct places. Details below! 🔗

👍

We've been rolling out a redesigned docs experience for some time now—check out this page for the details!

The legacy docs style is now deprecated and is not receiving any bug fixes. All changes below are only applicable to the new docs experience (unless otherwise noted). We'll communicate a sunset timeline to any remaining legacy customers soon.

✨ New & Improved

  • As previously mentioned, we’ve been hard at work re-thinking how Enterprise admins distinguish between user roles and how to simplify the process of managing multiple projects at scale. We’ve made some major improvements and our beta is now underway! This release includes even more improvements to this beta. If you're an Enterprise project administrator and you're curious about what we've been working on, we’d love for you to try it out! Drop us a line at [email protected]. 👥

🛠 Fixes & Updates

  • There were certain situations where the “Clear Response” button in the API Reference wouldn’t do its one job of clearing responses. Thankfully, this release fixes that! 🚮
  • Fixed an issue in the API Reference where arrays weren’t properly displaying their children if the children were certain polymorphic objects. 🚸
  • A few minor Windows-friendly copy edits in certain places. 🪟
  • A few small routing fixes for Enterprise projects. 🧭

Hope you're staying safe and healthy! Thanks for being a part of the ReadMe community, folks.

—Kanad and the ReadMe Team :owlbert:

📘

What is the Owlet Weekly Update?

Thanks for tuning in to another edition of our Owlet Weekly Update—an owlet-sized update (posted every week to the ReadMe Changelog) on the product updates we're shipping here at ReadMe. We'd love to hear what you think of these updates at [email protected]!

Hello and happy Winter Olympics season, y'all! To celebrate, we're shipping a luge huge list of fixes and improvements, including a minor tweak to a curl code sample. See what I did there? I tried to think of puns for everything else we shipped, but it went... downhill from there. Let's shred some gnar! (I'm so sorry) ⛷️

👍

We've been rolling out a redesigned docs experience for some time now—check out this page for the details!

The legacy docs style is now deprecated and is not receiving any bug fixes. All changes below are only applicable to the new docs experience (unless otherwise noted). We'll communicate a sunset timeline to any remaining legacy customers soon.

✨ New & Improved

  • As previously mentioned, we’ve been hard at work re-thinking how Enterprise admins distinguish between user roles and how to simplify the process of managing multiple projects at scale. We’ve made some major improvements and our beta is now underway! This release includes even more improvements to this beta. If you're an Enterprise project administrator and you're curious about what we've been working on, we’d love for you to try it out! Drop us a line at [email protected]. 👥
  • As previously announced, we’re in the early stages of our GraphQL beta! This release includes additional work on that front. If your API is powered by GraphQL and are interested in helping us build the best GraphQL developer experience in the game, get in touch at [email protected]! 📈
  • This release includes even more improvements to our soon-to-be-released editor, which you can get a sneak peek of in our discussion forums! ✍️
  • This release includes clearer validation error messages for certain OpenAPI file edge cases (i.e. complex response header definitions). ⚽
  • We now do a better job of handling tag data in OpenAPI file in certain cases (e.g. empty tags, whitespace, etc.). 🏷
  • Posts from your discussion forum are now included in project clones. ♊

🛠 Fixes & Updates

  • Rewriting history is usually not a good thing! This is true in a lot of contexts, but the one we're referring to is with our search modal—there was a bug where clicking on a search result and then clicking the Back button in your web browser skipped over the page you were on. Thankfully, this behavior was fixed in this release. 🔍
  • Fixed certain rendering behavior in the API Reference for additionalProperties fields in response object definitions. ⌨️
  • Fixed an issue in the API Reference where certain polymorphic inputs weren’t properly displaying their default values. 🔠
  • Fixed an issue where variables and glossary items were unable to handle certain special characters. 🔢
  • Fixed an issue where certain logo link configurations weren’t working properly. 🔗
  • Fixed one of our example cURL commands in the dashboard. 🥌
  • Minor fixes to scroll-to-top behavior for certain URLs. 📜

Hope you're staying safe and healthy! Thanks for being a part of the ReadMe community, folks.

—Kanad and the ReadMe Team :owlbert:

📘

What is the Owlet Weekly Update?

Thanks for tuning in to another edition of our Owlet Weekly Update—an owlet-sized update (posted every week to the ReadMe Changelog) on the product updates we're shipping here at ReadMe. We'd love to hear what you think of these updates at [email protected]!

Hello! I'm coming to you shortly after learning that Rihanna is pregnant so I am physically unable to write an introduction about anything else. Anyways, enjoy this week's Owlet Weekly Update! ☔

👍

We've been rolling out a redesigned docs experience for some time now—check out this page for the details!

The legacy docs style is now deprecated and is not receiving any bug fixes. All changes below are only applicable to the new docs experience (unless otherwise noted). We'll communicate a sunset timeline to any remaining legacy customers soon.

✨ New & Improved

  • As previously mentioned, we’ve been hard at work re-thinking how Enterprise admins distinguish between user roles and how to simplify the process of managing multiple projects at scale. We’ve made some major improvements and our beta is now underway! This release includes even more improvements to this beta. If you're an Enterprise project administrator and you're curious about what we've been working on, we’d love for you to try it out! Drop us a line at [email protected]. 👥
  • Like many of you, we’ve had our eyes on the GraphQL hype train for some time now. Well we’re excited to announce that we’ve officially finally entered the beta for our new GraphQL API Reference! Get the details on everything here. 📈
  • Now here’s a highly anticipated feature—we now render an icon next to each of your search results to distinguish which section of your documentation each result is coming from! 🔍
  • This release includes even more improvements to our soon-to-be-released editor, which you can get a sneak peek of in our discussion forums! ✍️
  • This release includes improved international support for variables and the glossary. 🌏

🛠 Fixes & Updates

  • Our file handling has been vastly improved in the API Reference! Hitting "Try It!" now does a far better job of preserving your file contents in multipart/form-data requests. As part of this, we've also added support for the explode and style parameters within the encoding object for multipart/form-data requests. 🗃
  • Semi-related to the above, we’ve also fixed a few edge cases around query string handling. 🧵
  • This release includes various accessibility improvements to our modals throughout the product! You no longer have to deal with focus trapping issues and you can now consistently escape the modal using the—you guessed it—escape key. ⌨️
  • Good news if you’ve been a bit lazy to write response example values—the API Reference now falls back to displaying the default value as an example if you don’t include any examples. 🍂
  • If your API sends a simple boolean response, we previously used to display something like OK... but as of this release, we actually render the boolean value properly! 🆗
  • This release continues on last week’s response headers sans body work and brings better support to the response examples side of things. ⚽
  • I’ve got 9,007,199,254,740,991 problems but the inability to handle large integers in the API Reference ain’t one—at least as of this release. 💯
  • A few tweaks to prevent some jumpiness when navigating to the Landing Page. 🦘

Hope you're staying safe and healthy! Thanks for being a part of the ReadMe community, folks.

—Kanad and the ReadMe Team :owlbert:

📘

What is the Owlet Weekly Update?

Thanks for tuning in to another edition of our Owlet Weekly Update—an owlet-sized update (posted every week to the ReadMe Changelog) on the product updates we're shipping here at ReadMe. We'd love to hear what you think of these updates at [email protected]!

Hello and welcome to another Owlet Weekly Update, y'all! Unlike Aaron Rodgers, we had wins on multiple fronts this week. Details below! 🤡

👍

We've been rolling out a redesigned docs experience for some time now—check out this page for the details!

The legacy docs style is now deprecated and is not receiving any bug fixes. All changes below are only applicable to the new docs experience (unless otherwise noted). We'll communicate a sunset timeline to any remaining legacy customers soon.

✨ New & Improved

  • As mentioned last week, we’ve been hard at work re-thinking how Enterprise admins distinguish between user roles and how to simplify the process of managing multiple projects at scale. We’ve made some major improvements and our beta is now underway! This release includes even more improvements to this beta. If you're an Enterprise project administrator and you're curious about what we've been working on, we’d love for you to try it out! Drop us a line at [email protected]. 👥
  • This release includes little performance bumps for initial page loads in the dashboard and the hub, as well as client-side bundle size reductions. 🚀
  • This release includes even more improvements to our soon-to-be-released editor, which you can get a sneak peek of in our discussion forums! ✍️

🛠 Fixes & Updates

  • Fixed a couple issues surrounding the Landing Page: one is a small styling issue for recently-upgraded projects, and the other is a URL issue where attempting to navigate to the landing page on single-project enterprise projects would instead lead you into a mysterious abyss. 🌀
  • Good news for you power search users: this release fixes a longstanding issue where the search bar would periodically drop certain characters as you were furiously typing. 🔍
  • Fixed a gnarly issue with allOf schemas in OpenAPI files where merging certain objects would yield unexpected results due to missing types. ❓
  • This release includes improved handling of response header descriptions that don’t include response object descriptions in the API Reference. 📝
  • Fixed an issue in the API Reference where certain nested integer fields were rendering as strings. 🔢
  • Fixed a little typo in the dashboard where the word “discussions” had one too many s’s. 🐍
  • Restored a few tooltips in the Metrics dashboard that had temporarily disappeared. 🎩
  • Fixed some issues surrounding zero-config metrics for Enterprise projects. 📊
  • A few minor styling fixes in the dashboard. 💅

Hope you're staying safe and healthy! Thanks for being a part of the ReadMe community, folks.

—Kanad and the ReadMe Team :owlbert:

📘

What is the Owlet Weekly Update?

Thanks for tuning in to another edition of our Owlet Weekly Update—an owlet-sized update (posted every week to the ReadMe Changelog) on the product updates we're shipping here at ReadMe. We'd love to hear what you think of these updates at [email protected]!

Hello and welcome to another Owlet Weekly Update! I've been informed by our legal team that Wordle references are no longer cool nor relevant, but that's fine with me because this release is so substantial that there's no way we could possibly summarize it in five letters: OpenAPI validation improvements, a new beta program for Enterprise authentication and team management, and so much more. Details below! 🖐️

👍

We've been rolling out a redesigned docs experience for some time now—check out this page for the details!

The legacy docs style is now deprecated and is not receiving any bug fixes. All changes below are only applicable to the new docs experience (unless otherwise noted). We'll communicate a sunset timeline to any remaining legacy customers soon.

📘

Programming Note

This post is being backdated to January 13th, 2022 but was actually published on January 26th, 2022. Apologies for the delay folks!

✨ New & Improved

  • We know that a lot of ReadMe Enterprise customers are often dealing with many users at a time, all of whom have different permissioning requirements for different projects. Well it doesn't have to be so complicated! For several months now, we’ve been hard at work re-thinking how Enterprise admins distinguish between user roles and how to simplify the process of managing multiple projects at scale. We’ve made some major improvements and we’re excited to announce that we’ve officially entered our beta period! If you're an Enterprise project administrator and you're curious about what we've been working on, drop us a line at [email protected]! 👥
  • You may have noticed that a previously valid OpenAPI or Swagger file is now failing certain checks in our validator. That’s a good thing! That’s because this release includes a loooot of cool new tricks in our OpenAPI and Swagger validation. Our validator now flags a lot of common OpenAPI mistakes that could cause quirks in your documentation, including duplicated operation IDs, invalid parameters, invalid discriminators, and much more. 🪄
  • In the last couple months, we shipped completely redesigned login pages that are more tailored to your documentation. This release includes further enhancements that allow more granular control over this page’s theme. 🎨
  • Several notable yet barely noticeable performance improvements in the API Reference, particularly for endpoints that contain complex response schemas. 🐎
  • This release includes even more improvements to our soon-to-be-released editor, which you can get a sneak peek of in our discussion forums! ✍️
  • This release adds several little enhancements to the the Metrics dashboard, including better HTTP method information in the API Calls table. 🏓

🛠 Fixes & Updates

  • We’ve enhanced how we persist your credentials between endpoints in the API Reference. We previously only persisted your authentication data, but as of this week, we now include any relevant server URL data as well! 🔗
  • We’ve made our search bar a bit less macOS-centric and no longer render a symbol for our non-macOS friends out there. 🍎
  • Fixed an issue where toggling between API logs under the Request History wouldn’t properly show the selected log. 🪵
  • Fixed some navigation quirks for enterprise projects with custom child path names. 🧭
  • Fixed a sidebar scrolling issue affecting certain projects with lots of sidebar items. 📜
  • Minor security fixes. 🔐

Hope you're staying safe and healthy! Thanks for being a part of the ReadMe community, folks.

—Kanad and the ReadMe Team :owlbert:

📘

What is the Owlet Weekly Update?

Thanks for tuning in to another edition of our Owlet Weekly Update—an owlet-sized update (posted every week to the ReadMe Changelog) on the product updates we're shipping here at ReadMe. We'd love to hear what you think of these updates at [email protected]!