67
94
+ 1
70

What is ReadMe.io?

Collaborative Developer Hubs
ReadMe.io is a tool in the Documentation as a Service & Tools category of a tech stack.

Who uses ReadMe.io?

Companies
43 companies reportedly use ReadMe.io in their tech stacks, including UNION, Watsi, and ReadMe.io.

Developers
18 developers on StackShare have stated that they use ReadMe.io.

ReadMe.io Integrations

Why developers like ReadMe.io?

Here’s a list of reasons why companies and developers use ReadMe.io
ReadMe.io Reviews

Here are some stack decisions, common use cases and reviews by companies and developers who chose ReadMe.io in their tech stack.

Noah Zoschke
Noah Zoschke
Engineering Manager at Segment · | 29 upvotes · 204.2K views
atSegmentSegment
Postman
Postman
Markdown
Markdown
ReadMe.io
ReadMe.io
Swagger UI
Swagger UI
#Documentation
#Api
#QA

We just launched the Segment Config API (try it out for yourself here) — a set of public REST APIs that enable you to manage your Segment configuration. A public API is only as good as its #documentation. For the API reference doc we are using Postman.

Postman is an “API development environment”. You download the desktop app, and build API requests by URL and payload. Over time you can build up a set of requests and organize them into a “Postman Collection”. You can generalize a collection with “collection variables”. This allows you to parameterize things like username, password and workspace_name so a user can fill their own values in before making an API call. This makes it possible to use Postman for one-off API tasks instead of writing code.

Then you can add Markdown content to the entire collection, a folder of related methods, and/or every API method to explain how the APIs work. You can publish a collection and easily share it with a URL.

This turns Postman from a personal #API utility to full-blown public interactive API documentation. The result is a great looking web page with all the API calls, docs and sample requests and responses in one place. Check out the results here.

Postman’s powers don’t end here. You can automate Postman with “test scripts” and have it periodically run a collection scripts as “monitors”. We now have #QA around all the APIs in public docs to make sure they are always correct

Along the way we tried other techniques for documenting APIs like ReadMe.io or Swagger UI. These required a lot of effort to customize.

Writing and maintaining a Postman collection takes some work, but the resulting documentation site, interactivity and API testing tools are well worth it.

See more
Todd Gardner
Todd Gardner
President at TrackJS · | 4 upvotes · 98.5K views
atTrackJSTrackJS
Jekyll
Jekyll
GitHub Pages
GitHub Pages
ReadMe.io
ReadMe.io
Read the Docs
Read the Docs
Gatsby
Gatsby

We recently needed to rebuild our documentation site, currently built using Jekyll hosted on GitHub Pages. We wanted to update the content and refresh the style to make it easier to find answers.

We considered hosted services that could accept our markdown content, like ReadMe.io and Read the Docs, however both seemed expensive for essentially hosting the same platform we already had for free.

I also looked at the Gatsby Static Site generator to modernize Jekyll. I don't think this is a fit, as our documentation is relatively simple and relies heavily on Markdown. Jekyll excels at Markdown, while Gatsby seemed to struggle with it.

We chose to stick with the current platform and just refresh our template and style with some add-on JavaScript.

See more
Yonas Beshawred
Yonas Beshawred
CEO at StackShare · | 2 upvotes · 12.5K views
atStackShareStackShare
ReadMe.io
ReadMe.io

We're using ReadMe.io for our public API (which has been in closed Beta forever), you can see the docs here: https://docs.stackshare.io. They've got all the stuff you'd expect: custom domain support, lots of integrations, etc.

The design looks great and having the actual JSON responses on the right side panel is really nice. My favorite feature is the API Explorer which allows you to test out real API calls once you've entered a key.

We haven't really promoted the API since we're not opening up access just yet, but once we do I know ReadMe's got us covered!

See more

ReadMe.io's Features

  • Collaboration - Crowdsource your docs! Users can keep docs current by suggesting changes.
  • API Explorer - Let users play with your API right inside the documentation.
  • GitHub Sync - Keep auto-generated reference docs synced with your actual code.
  • Editor - Markdown-based drag-and-drop editor makes documentation almost fun.
  • Theme Builder - Easily create a beautiful dev community that matches your brand.
  • Support - Let users ask questions and request features in the support forums.
  • Versioning - Maintaining old or testing beta versions of your docs is a breeze!
  • Application Keys - Your users can view their application keys embedded right in the docs.

ReadMe.io Alternatives & Comparisons

What are some alternatives to ReadMe.io?
ReadMe.io
Collaborative Developer Hubs
Postman
It is the only complete API development environment, used by nearly five million developers and more than 100,000 companies worldwide.
Swagger UI
Swagger UI is a dependency-free collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation and sandbox from a Swagger-compliant API
Apiary
It takes more than a simple HTML page to thrill your API users. The right tools take weeks of development. Weeks that apiary.io saves.
jsdoc
JSDoc 3 is an API documentation generator for JavaScript, similar to JavaDoc or PHPDoc. You add documentation comments directly to your source code, right along side the code itself. The JSDoc Tool will scan your source code, and generate a complete HTML documentation website for you.
See all alternatives

ReadMe.io's Followers
94 developers follow ReadMe.io to keep up with related blogs and decisions.
ayoshing
MARY ANTHONY
John Alton
Anderson Cardoso
Mohamma76685757
Ashok Logan
Youssef AIT NASSER
Milan Stanojević
MartinaFKentico
ksoliman