Enterprise API Docs—What’s the Difference?
When I started at ReadMe four years ago, we had two plans: our Startup ($99) and Business ($399) tiers. As the first sales, marketing, and growth hire, my goal was to get more people to…
How to Increase Your API Users
The Basics. What’s the point of building an API if nobody uses it? In the API world, the saying “If you build it they will come,” absolutely doesn’t hold true. As a matter a fact,…
How we did our first Net Promoter Score, and why you should too!
We recently completed our first Net Promoter Score (NPS). It’s something we’ve all seen before, a simple email or pop-up that asks “On a scale of 0-10, how likely are you to recommend this product…
Precision With Every Pixel
This is a guest blog post by the über-talented Amy Devereux. She’s been helping ReadMe make all things pretty, and is the designer behind 365cons.com. As you may have noticed, we use a lot of icons here…
Jamstack Attack! Static Sites, Dynamic APIs, and a Killer DX
“JAMstack” Google search interest, starting in 2017.(Google Trends) What is the Jamstack? “Maybe like a Jam Session. … I'm picturing a group of people jamming out (musically) in a garage or warehouse space.” —Owlbert, guess #5…
Best Practices for Writing API Docs and Keeping Them Up To Date
Developers respect clean, simple code. We have to be experts at finding ways to do more with less. And while that skill set is highly valued in development, it doesn't always transfer over to writing…
Reimagining ReadMe’s Markdown Engine
Migration Guides & Documentation→ If you’ve worked on any technical docs recently, you’ve almost definitely written Markdown. Love it or hate it, it’s the closest thing to a standard in terms of how we document our…
The Best REST API Template
We tend to set a low bar when it comes to documenting our APIs. Developers can stomach poring over dense docs for a product that they're interested in using, such as Google Maps or Twitter.…
Writing a Cron Job Microservice With Serverless and AWS Lambda
We recently had a situation where we needed to create a new cron job to fetch all users from our database who are coming to the end of their trials and insert them into our…
Microservices vs API
The terms API and microservices are often thrown around pretty loosely. What do these terms actually mean? How do they relate to one another? In this piece, we’ll tackle these questions, as well as answer…
API Authentication Methods for OAS Security
What keeps you up at night as an API developer or professional? According to Postman's State of API Report 2023, over 40,000 developers and API professionals identified “improper authentication, authorization, or access control” as the…