Also check out http://apiblueprint.org/ which seems to be by the folks at Apiary.io

... and this blog post all about API documentation: http://codebetter.com/glennblock/2014/02/06/a-discussion-on-...