RESTful API doc spec & API Blueprint awesome resources

API Doc Specs

Introdce to API Doc Spec

Misc articles

Swagger

Swagger is a simple yet powerful representation of your RESTful API. Swagger Specification has been donated to the Open API Initiative (OAI) and has been renamed to the OpenAPI Specification.

RAML

The simplest way to design APIs

RESTful API Modeling Language (RAML) makes it easy to manage the whole API lifecycle from design to sharing. It’s concise - you only write what you need to define - and reusable. It is machine readable API design that is actually human friendly.

Write once. Use many. Creative laziness encouraged.

Slate

Slate helps you create beautiful, intelligent, responsive API documentation.

Others

API Blueprint

Getting Start / Tutorial

MSON (Markdown Syntax for Object Notation)

aglio

An API Blueprint renderer that supports multiple themes and outputs static HTML that can be served by any web host. API Blueprint is a Markdown-based document format that lets you write API descriptions and documentation in a simple and straightforward way.