Our API docs are now hosted on Github

Since the all new Basecamp’s API launch, our Developerland site was feeling a bit dated without GitHub’s wonderful styling and syntax highlighting. Spring is a time for cleaning, and that includes API documentation!

My favorite new feature of the API documentation is that each endpoint now has its own permalink. For example, here’s Highrise’s Get deal endpoint.

Found a typo or have a clarification for the API documentation? Feel free to open a pull request on any of the repos. If you spot a bug or have a question for us, opening a support ticket will be the fastest way you can get an answer.

Michael

Zach

This is a great start, makes a lot of sense. We at Apiary.io are huge fans of making API documentation a community project, complete with pull-requests and all.

We’re building tools that allow you to write API documentation in enhanced Markdown DSL, share it on Github, generate nice documentation out of the DSL, debug your real API calls using an integrated proxy, even automatically test the documentation with your real API. You should check it out, we’d love to work with you.

Right now it looks like you have to put absolute URLs in README.md to each raw documentation file.

Nick

on 30 May 12

sysprv, the formatting on the normal rendered markdown pages is good enough. We would have turned off edits from non-contributors anyway, and pull requests effectively let us do this review process in the open.