В дополнение к тому что уже привели.
apiblueprint +
aglio - использую в данный момент. В частности мне требовался инструмент позволяющий писать читабельную документацию и при этом DRY-ить декларацию типов.
Сейчас финализируется RAML 1.0 и я планирую перебираться на него. К сожалению с инструментарием придется чуть подождать но пока он выходит самым гибким и приятнее сваггера.