Happy Tuesday Thursday folks! Apologies for the delay on this week’s release—we’ve been spending the week huddled on Zoom for our fall offsite (check out Greg’s Twitter recap of our summer offsite here)! Fortunately, we’ve still been busy—this release includes some great design and performance updates as well as even more refreshed code samples. Details below! :owlbert-reading:

✨ New & Improved

  • We’re keeping the “get our JavaScript code samples with the times” energy going from last week and taking it from the server to the browser! This week, we’re finally saying goodbye to XMLHttpRequest in favor of the more widely used Fetch API. See it in action in our API reference by clicking the JavaScript tab above the code samples. 🚂
  • A couple eagle-eyed folks noticed that Markdown list elements were ever so slightly different in color than the rest of the text on a page. While we all love a little pop of color from time to time, this wasn’t the time nor place. This release includes a couple touch-ups on that front. 🖌️
  • We've included some performance optimizations in this release that should help with the initial load times on your project dashboard—with more optimizations to come soon. 🚀
  • The trusty Save button in the dashboard got a nice little refresh! Check it out and let us know what you think. 🎨

🛠 Fixes & Updates

  • We had enterprise customers that were running into issues where an Auth0 SAML connection would apply to one enterprise group of projects, but not any of their other project groups. If you’ve ever seen an ad on TV for a $5 footlong only to walk into a Subway that does not in fact honor that deal, you can understand how painful this can be. While we have no control over your local Subway deals, we’ve included some fixes to apply a single SAML connection across all of your project groups. 🥪
  • There was an issue within the API Explorer for the last week or so where certain text input fields would lose focus, meaning you’d have to click back into the field after entering each individual character. Great news if you’re an Architect in the Bad Place in need of inspiration, but bad news for everyone else. Fortunately, this release includes a fix for the rest of us. 🌤️
  • A couple of small security fixes to further prevent hackers from hackity-hacking into the mainframe. 🧑‍💻
  • Some minor circular reference handling fixes in the API Explorer. 🔄

Thanks again for reading and for being a part of the ReadMe community! Go vote! 🗳️

—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 Tuesday to the ReadMe Changelog) where we provide an overview of the product updates that went out as part of our new Tuesday release cycle. As we refine our format and process for providing these updates, we'd love to hear what you think at [email protected]!

Hello and welcome to another edition of the Owlet Weekly Update! Major thanks to our sponsor this week—teenagers! In honor of the teens, we finally get with the times and add node-fetch support to our API Explorer. Read on for this and all of the other #hip features and improvements that were shipped in this release! 🛹

1125

Better recharge those Juuls, kids.

✨ New & Improved

  • As many of you vape-loving, Node.js-using teens out there are aware, the request module is sooooo last year and was officially deprecated this past February. Despite all the time that has passed, the Node.js code samples in the API Explorer still used request… until now! With this major release (version 🎱 of the API Explorer, for those keeping score), we’re finally boarding the node-fetch train. Toot toot! 🚂
  • This release also contains some big improvements to our GitHub Integration. Now, the workflow validates your OpenAPI/Swagger file prior to upload, takes advantage of our wonderful new(ish) API error messages (long overdue, sorry folks!), and includes some new debug logging options which should make troubleshooting a breeze. 🍂
  • As with everything we do here at ReadMe, we're always striving to make our API Explorer as inclusive as possible. Well as of this release, the API Explorer officially supports HTTP headers of all shapes and sizes—in other words, it now preserves casing! See here for a demo. 🔠
  • Have you tried out the api code samples in your reference section yet? Well there’s no better time than the present—this release includes even more improvements on that front. 🚀
  • Good news for documentation that contains a subtle shoutout to ReadMe in the footer—we’ve made a few design tweaks to make the shoutout a little bit more elegant and subtle. 🎨

🛠 Fixes & Updates

  • Some of you were seeing a completely baffling “duplicate key error” message when trying to update your API specification via a PUT request. Major apologies if this caused you to completely question your sense of reality. While I can only partially assure you that this is real life, I can say with confidence that this release includes a much clearer error message (and in case you’re wondering—yes, the error contains a poem). 🖋️
  • As mentioned last week, we made some navigational improvements to our knowledge base! This release includes some housekeeping to make sure that our documentation links are up-to-date. (And if you see any broken links, please let us know!) 🔗
  • Minor bug fixes for projects that downgrade (or upgrade, depending on perspective) to ReadMe Free. 📈
  • Other general stability improvements to the API Explorer. 🔧

Thanks for reading and for being a part of the ReadMe community!

—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 Tuesday to the ReadMe Changelog) where we provide an overview of the product updates that went out as part of our new Tuesday release cycle. As we refine our format and process for providing these updates, we'd love to hear what you think at [email protected]!

Welcome to another Owlet Weekly Update! I'm going to state the obvious here folks—we all learn best when we learn by example. And there's no better example right now than this week’s Owlet Person of the Week (which is totally a thing, trust me)—American men’s basketball player LeBron James! In honor of Mr. James and the example he sets for all of us, we’ve added response examples to the API Explorer. Read onward for details on this and so much more! 🏀

2720

🐐

✨ New & Improved

  • As alluded to above, we now support defining response examples via the example keyword. What does this mean? You can now create sample API responses that your users can preview before they even hit the “Try It” button! This makes it even easier for your users to know what to expect from your API. See it in action here! 👀
  • If you’ve ever brought your OpenAPI/Swagger file into ReadMe, you’ll know that we have a variety of extensions available so you can customize your reference guides to your liking. These properties used to apply to your entire reference section, but why paint with such a broad brush? With this release, you can now specify options at the operation level. Hooray for smaller brushes! 🖌️
  • We just made some changes to our knowledge base to make it easier to navigate. Let us know what you think! 🧭

🛠 Fixes & Updates

  • What’s a pull request on GitHub without the angry “any update?” comments? Well, ReadMe’s version of pull requests (which most of you know as Suggested Edits) were temporarily unable to load the comments section. Great in theory for preventing abuse, bad in reality for actually conversing with the person that submitted the suggested edit. For better or worse, this release brings the comments section back. 💨
  • Did you know that API Metrics uses your OpenAPI definition to help you understand your usage better? For example, when viewing your most popular API endpoints, we group certain URLs together if they share path parameters! With this release, the dashboard will offer some suggestions so you can make the most of your metrics. 📈
  • All response examples deserve to be treated fairly… including those that are passed via $ref! Now, we properly render response examples regardless of how they’re referenced. 🔄

Thanks for reading and for being a part of the ReadMe community(and congratulations again to LeBron James on winning Owlet Person of the Week)!

—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 Tuesday to the ReadMe Changelog) where we provide an overview of the product updates that went out as part of our new Tuesday release cycle. As we refine our format and process for providing these updates, we'd love to hear what you think at [email protected]!

Hello and happy October, friends! Thanks for tuning into another Owlet Weekly Update. We still have a lot of folks out and a lot of bigger initiatives that we're working on (stay tuned 👀), but in the meantime—we've got great news for fans of analytics, color, and Migos. Details below! 🎃

2720

(Team Cardi, for the record)

✨ New & Improved

  • We’ve enhanced our Segment integration to support custom domain proxies—meaning you’ll be able to proxy all your tracking events through your domain. 🌐

🛠 Fixes & Updates

  • Much like with the tech industry as a whole, a few customers noticed a little lack of color in their code samples lately. Well while we’re still a part of the fight for a more diverse and inclusive tech industry, (check out our blog post on our interview process and our careers page—QTBIPOC encouraged to apply!) this release includes a fix to our syntax highlighter. Hooray for color! 🌈
  • “Offset!” -Offset (also us, adjusting the margins of our new table of contents to better align with the first line of content). 🎨
  • Authentication fixes for enterprise projects that use both ReadMe and SAML login flows. 🔐
  • “Patched” up the vertical alignment on the PATCH badge. 🏴‍☠️
  • Small scrollbar fixes in the dashboard. 🖱️

Once again, thanks for reading and for being a part of the ReadMe community!

—Kanad and the ReadMe Team :owlbert:

Happy Tuesday, folks! We have a lot of folks out this week (but don't worry, we'll wake them up when September ends!) so this update is a bit on the shorter side. Nevertheless, lots of little fixes for our grammar nerds and our legacy users—details below! 👇🏽

2720

These references are only going to get more obscure. Sorry.

🛠 Fixes & Updates

  • For those of you ReadMe community members that still exist in the Dark Ages (in other words, you’re still on the legacy version of our platform), you may have noticed issues reordering documentation pages. Thankfully, this release includes a fix for that! Sorry for making the Dark Ages even darker, folks. (If you want to enter the Age of Enlightenment, check out our FAQ on upgrading to our current platform—it’s completely free and our amazing support team makes it super easy to do!) 🏰
  • Our image uploader was briefly having trouble loading on legacy projects and in a handful of other places. Should be resolved now—upload responsibly, kids! 🖼
  • Some of you may have been completely baffled by the errors you were seeing when creating a new project. This release should quell the bafflement. 💭
  • Another week, another discovery of some atrocious typos by our copy queen Shinae. 🤓
  • Fixes to some category syncing issues when uploading OpenAPI files. 🔄
  • Patches to a couple of tiny design regressions. 🎨
  • Small security fixes. 🔐

Thanks, as always, for reading and for being a part of the ReadMe community!

—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 Tuesday to the ReadMe Changelog) where we provide an overview of the product updates that went out as part of our new Tuesday release cycle. As we refine our format and process for providing these updates, we'd love to hear what you think at [email protected]!

Hello hello, welcome to yet another Owlet Weekly Update! This week's fixes were focused on security and reliability, including to the the API Explorer, the Page History feature, and more. Details below! :owlbert-thinking:

2720

👻

✨ New & Improved

  • Everything’s bigger in Texas—including our limits on how many custom pages you can add to a project. As of this release, at least. Disclaimer: these changes also apply to our non-Texan customers as well. 🤠
  • Minor stability improvements when pulling up Page History in the dashboard. ⏳

🛠 Fixes & Updates

  • If you’ve ever merged a Suggested Edit into your ReadMe documentation, you may have noticed that the Page History would incorrectly attribute the changes to the creator of the page, rather than the person that merged the Suggested Edit. Well this isn’t Drake’s discography! With this release, content updates are properly credited. 📝
  • Like dates (the fruit), our dates (the UI component) didn’t quite sit right with everyone. So, we decided to metaphorically go with an apple and… okay I’ve lost the metaphor here, but what I’m trying to say is… all date and date-time inputs in the API Explorer are string inputs rather than date and date-time picker components. Sorry if your browser was allergic. 🍎
  • We released a Ruby SDK for API Metrics a few weeks ago, and with that came some onboarding docs that had some glaring typos—which don’t exactly inspire confidence during an onboarding experience. Thanks to Ruben, who wrote in pointing those out! This release includes some spelling improvements which should hopefully put your mind at ease. 😌
  • Looks like some of you kids had a little too much fun… because this release includes a few additional guardrails for our previously mentioned API endpoint for applying for a job with us. Be sure to try it out if you haven’t already done so! 💙
  • For those of you that exist on a plane of chaos, our API Explorer is now operating on your level. In other words, our API Explorer file uploader now has support for file names that contain parentheses. 📡
  • We did it folks. We’re officially 100% secure now! Just kidding (probably). But this release includes a lot of little security fixes that get us reeeeaaal close. 🔐
  • Super tiny fixes to the setup and deployment workflow for Custom OAuth Login. 🚀
  • Better support for cyclical references in the API Explorer. 🔁

It's National Voter Registration Day, sodon't forget to register to vote! Thanks again for reading and for being a part of the ReadMe community,

—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 Tuesday to the ReadMe Changelog) where we provide an overview of the product updates that went out as part of our new Tuesday release cycle. As we refine our format and process for providing these updates, we'd love to hear what you think at [email protected]!

Hello and welcome to another Owlet Weekly Update! Question for you—how would you describe the opposite of “death by a million cuts”? I’m thinking... “life by a million snacks”? I’d say that’s an adequate descriptor for this release—lots of small, substantial updates that should speed things up and fix some annoyances. Details below!

📘

Slightly Delayed Release This Week

You may have noticed that this Changelog post was published on a Thursday rather than a Tuesday! Unfortunately, we ran into some last-minute issues with this release. Fortunately, we figured them out. We should be back to our regularly scheduled programming (i.e. our Tuesday release cycle) next week. Thanks for your patience, folks!

2720

✨ New & Improved

  • We're working on a bigger initiative to move away from legacy AngularJS code towards a modern front end architecture (pssst... come work with us!) In that vein, we completely rewrote the table of contents (TOC) from the ground up as a server-side-rendered React component, just like our Markdown engine. What exactly does this mean? We now use good, old-fashioned HTML anchor links for scrolling to different sections, and native CSS sticky positioning to pin the TOC to the top of the page, rather than custom legacy AngularJS code. This results in a TOC experience that’s lighter, faster, and more reliable. And the best part? It looks exactly the same. 💖
  • This release includes some major server-side performance improvements, specifically in reducing the number of requests to our search index and some general optimizations to our server middleware. What does this mean for you, dear reader? Faster load times for your documentation. We love to see it! 🚀
  • At ReadMe, we strongly believe that your documentation should be customized to your users and their needs… even when they tell you to “delete your account.” Previously, project owners had to contact support in order to delete their own projects. This release grants project owners the ability to delete on their own. 🗑
  • I’ve said it before and I’ll say it again—even our users of ReadMe Free deserve nice things! Including API access. Well, starting with this release, our dear free users now have full access to the ReadMe API! POST responsibly, folks. 🍻

🛠 Fixes & Updates

  • As you may have heard, we recently added an endpoint to the ReadMe API for applying for a job with us! Well, we have an exciting announcement on that front: In the last week, we received about a million new applicants! Just kidding. But seriously, we have since discovered that lots of people want to play around with an API without actually applying for a job. To address this, we’ve added a new dontReallyApply parameter to the API, which, as the name implies, allows you to see the API in action without actually applying. We won’t judge! (But we do see everything you write, so don’t have too much fun with it, kids.) 🧐
  • What is this, mid-summer 2019? Prior to this release, some of our emails were still linking to our old Twitter handle (big thanks to Carlton, who kindly wrote in pointing this out!). Last year, we spent an undisclosed amount of money to obtain the @readme Twitter handle and we clearly we haven’t been getting our money’s worth. But, this release updates our handle in those emails, so now you have no excuse to not be following us! 📧
  • If you post something to your Changelog and it doesn’t show up in search results, does it even exist? Well not that I’m concerned about my readership numbers, but I’m sure you may have noticed that these Owlet Weekly Updates aren’t showing up in search results. Thankfully, we’ve identified the issue and Changelog posts should be showing up in search results again soon. 🔍
  • Good news, grammar nerds! Shinae, the official Copy Queen of ReadMe, got to work on our owl facts (i.e. what you see when you load the ReadMe project dashboard) and finally gave them some long-overdue grammatical fixes. Really sorry to those of you that winced at these grammatical disasters every time you loaded the dashboard. 🤓
  • So apparently, we were using an outdated shade of ReadMe Blue™ (legal disclaimer: not actually trademarked… yet?) for the little lines inside our ReadMe book logo in the top-left corner of the project dashboard. Did anyone else notice this? Me neither. The good news is our eagle-eyed CEO did and included a fix in this release! 💙

Thanks again for reading and for being a part of the ReadMe community!

—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 Tuesday to the ReadMe Changelog) where we provide an overview of the product updates that went out as part of our new Tuesday release cycle. As we refine our format and process for providing these updates, we'd love to hear what you think at [email protected]!

Happy Wednesday folks! We had an extended holiday weekend off here at ReadMe due to Labor Day, so this week’s update is a tad on the shorter side. This week's release includes Search API improvements, new ways to apply for a job with us, and more. Read on for the details!

✨ New & Improved

  • If you’ve read these release notes before, you know all too well that we overhauled our Search experience a couple months back! But some of you have rightfully pointed out that we’ve been neglecting the Search API. Because of this, the Search API has been returning outdated or misleading results due to it using an outdated index. Yikes. Well, good news—the massive Search improvements continue! Like the search experience in the docs, the Search API should now return better, more precise results. 🔍
  • It’s an API-driven world, and we’re just living in it, folks. Did you know that you can apply for a job at ReadMe via API? Well, it should be a little bit more obvious now—we just moved our job application endpoints into the official ReadMe API. You can check out the docs here. (But seriously, come work with us!) 👋

🛠 Fixes & Updates

  • This one is for my fellow KonMari stans! Previously, it was an ordeal to delete entire categories of pages in ReadMe. We didn’t want folks to accidentally delete categories, so we required them to delete every individual page within a category before they could delete the category itself. Now, when you attempt to delete a category, we give you a very clear warning that all pages within the category will also be deleted before moving forward. Thanks for tuning for this week’s episode of the Life-Changing Magic of Tidying Up Your Documentation Categories. 🧹
400

This documentation category does not spark joy.

In (belated) Labor Day solidarity with workers everywhere,

—Kanad and the ReadMe Team ✊🏽

📘

What is the Owlet Weekly Update?

Thanks for tuning in to another edition of our Owlet Weekly Update—an owlet-sized update (posted every Tuesday to the ReadMe Changelog) where we provide an overview of the product updates that went out as part of our new Tuesday release cycle. As we refine our format and process for providing these updates, we'd love to hear what you think at [email protected]!

Happy Tuesday folks! With the arrival of Virgo season comes lots of exciting improvements, including the ability to upload files in the API Explorer! ♍

You're probably wondering—how do file uploads relate to Virgo season? Not sure... everyone uploads files to the internet regardless of their chart, but I suppose Virgos triple-check that they have the correct file before uploading? 🤷🏽‍♂️

Read onward for details on this week's release (and rest assured, you won't find any more attempts at astrological references)! :owlbert-books:

✨ New & Improved

A cat uploading a hamburger to the internet—so as to visualize file uploading for the sake of this feature announcement.
  • As mentioned above, our API Explorer now has full support for file uploads! What does this mean? Now, for API endpoints that accept raw file data (e.g. endpoints with format: binary, like this one!), the API explorer will allow you to select a local file and send it to the API! 📡

    This sounds like a simple task but a lot is going on behind the scenes, and this was by no means a small undertaking. Shoutout to our API engineer, Jon, for making it happen! (Psst: we're also hiring another API engineer and also lots of other roles!) 👀

  • Saving pages is a foundational part of writing docs—and this release includes some yuuuge performance improvements when saving Guides pages in the dashboard. 🚀

  • Great news, Pythonistas! Our Python code snippets in the API Explorer are a little cleaner. 🧹

  • Minor error handling improvements in the API Explorer. ⚠️

🛠 Fixes & Updates

  • About a month ago, we made some Search improvements to render the keyboard shortcut based on what platform you were on. In a certain cases, it would display a flash of raw Angular code before rendering the proper keyboard shortcut. Sorry for the indecent exposure, folks. Happy to report that this release includes a cloak (of the ng variety—if you know, you know) and we've covered up. 🧥
  • If you've ever interacted with an API in ReadMe docs, you've most likely come across our good friend the red asterisk (*), which designates certain parameters as required. Turns out, our friend was getting stage fright and wouldn't show up for certain API parameters in our manual editor. Well, we've given the red asterisk a pep talk and it should show up properly now. 🎭
  • When you're on your 14-day trial of ReadMe, you should be able to test-drive all of the features available in our Business plan. As it turns out, for a brief period of time this was not the case—certain features were disabled when looking at your docs when they shouldn't be! Happy to report that we've tore down the (pay)wall. 🧱
  • Bad news, Pythonistas. In case you missed the announcement last week, we added a Python SDK for API Metrics! But in doing so, we also had some typos in our code samples. We deeply regret this error and extend our sincere apologies to our Pythonista community. 🐍
  • Stability fixes for Custom Login in projects that have API Metrics set up (which you should set up too!) 🧰
  • Small fixes to how the API Explorer handles security definitions and node-simple code snippets. 🔐
  • Minor versioned URL fixes. 🔗

Thanks again for reading and for being a part of the ReadMe community! And thanks to Jon (again) for taking over for me last week.

—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 Tuesday to the ReadMe Changelog) where we provide an overview of the product updates that went out as part of our new Tuesday release cycle. As we refine our format and process for providing these updates, we'd love to hear what you think at [email protected]!