> ReadMe was built almost entirely on Open Source projects, so we want to give back. If you're an open source project, shoot us an email and we'll upgrade you to the Developer Hub tier for free. It's the least we can do to give back.
Tried to email you and google bounced it. Turns out they have really obtuse policies for blacklists, and I can't figure out how to get my emails through. Any side channels to go through?
Readme has been incredible for hosting documentation of our open source project (rbkit.readme.io). Very responsive to support requests, even though we weren't really a paying a customer.
We (https://commando.io) use ReadMe for our API documentation. Beautiful docs, created easily. Can't wait for automatic client lib generation and what the future holds for ReadMe. Here are our docs http://docs.commando.io to view what is possible.
Yes ReadMe hosts. Absolutely agree, they need to implement full page caching, since the pages are basically static, and should not be rendered on each page load. This would be easily done with nginx, memcached, or redis.
Very cheap, super easy to scale, and basic authentication for private. Use your own domain, have full control over the domains and which S3 buckets your route to, and use ReadTheDocs templates which are great for documentation.
@gkoberger I'm curious to know how long you estimate this took you to implement and how many people comment on it. I'd estimate < 15 minutes and hundreds of people. Am I close?
You're almost exactly correct! About 15 minutes, and we got almost 200k hits because of it. It was on Smashing Magazine, Little Big Details, and just about every designer I like tweeted about it. Totally worth the time it took :)
We have Swagger support is (super early) beta; basically you can use your Swagger Spec right in ReadMe.
The focus is on more than just reference docs, though. ReadMe also has space for tutorials, topical guides, support, etc. And soon, we'll have things like onboarding flows and other things that customize the experience for each individual user.
As for Mashery and Apigee, features aside, last I checked, both start at about $10k/mo. They are more focused on API management; a "developer hub" is just a side effect for them.
There's nothing I like more than some great API documentation. Seriously, whenever I see that the author of an API/library writes good documentation (and examples!), it improves the quality of open source software a lot.
This is a super cool startup and I love that you are giving back to the community.
Noticed a bug: If you click on "Custom CSS" in the Examples section, the description starts out awkwardly with just "to stand out?" In the markup that paragraph is enclosed in an element called <Looking>. Maybe a misplaced character in a template?
Few apps have impressed me as much as Readme.io. The attention to detail and beautiful yet functional UI are superb! It was a delight to create the docs for http://www.js-data.io with Readme.io.
We're using Swagger incorporated with Flask-Restful, which has been quite straightforward to setup and maintain. I like ReadMe, but I feel like it needs stronger integrations to be compelling - e.g. autogenerating code examples for various languages.
Documentation is one of those very unsexy things that's so important but so many people and companies just tend to overlook. It's good to know there are companies aiming to fix this.
I'm a bit confused by the "use your own domain" option. I'm actively looking for a product with functionality like this, but it needs to be 100% self-hosted. "Use your own domain" suggests that ReadMe still handles data storage. Are there any fully self-hosted products that are similar to this?
Use your own domain is exactly how you interpreted it. There's nothing close to being equivalent, however there are a bunch of open source projects for documentation. Check out Swagger UI or Slate by TripIt.
Out of curiosity, what are your concerns about hosting documentation on a third-party site?
Our API docs need to be only available to authorized users. Due to the industry the API targets, self-hosting in a vetted secure environment is mandatory.
@Mashape we're fan of Greg and Gabriel since long time now.
They have done an amazing work with very limited resources. If all you need is a Documentation w/ Support they are the faster/cheaper solution for you. And the GUI is details oriented, unlike other complex/heavy Enterprise solutions.
I'd like to see it develop into a more generalized thing. Rather than offering nice looking docs, make it The Way to view docs for anything. Man/info pages 2.0 if you will. This should be to documentation what Github is to opensource.
I actually wanted to say Github should buy and integrate it (if it went the direction I Imagine). But on a second thought you want to incentivize proprietary stuff to be on there too, so it would have to remain somewhat separate from core Github.
And Oracle, haha. Oracle buying anything you like is scary :-D
They aren't necessarily incompatible. ReadMe will very soon support Swagger, and adds things like commenting, topical guides, code snippet generation, etc.
I've got an internal API that isn't available for public consumption, but would enjoy having beautiful documentation. Does ReadMe have an option for that?
Of course! Many of our users use it internally. All plans have an option to make documentation internal: either by inviting collaborators, or a site-wide password.
Where's that option? I created a project, and the closest thing I could find was in Versions. I clicked on the "(?) Public" thing, and it said that I couldn't change it or something. I don't want it to be public, but it never changed to a yes or no option, just stayed the same orange with a question mark.
Hey Colin! I'm @gkoberger's cofounder. We don't have a published roadmap, but we're hard at work. First priority is to release a rewritten template that will accommodate larger, more sophisticated documentation projects (another level of subcategorization, multiple documentation sections within one project, better search). Then, we'll start tackling more automatic ways of consuming code and creating documentation. We're ambitious, stay tuned.
> ReadMe was built almost entirely on Open Source projects, so we want to give back. If you're an open source project, shoot us an email and we'll upgrade you to the Developer Hub tier for free. It's the least we can do to give back.
Very cool.