Всех с Новым Годом :) В прошлом году мне нужно было задокументировать API, в котором сообщения идут в формате XML. Выбор пал на API Blueprint, потому что он выглядит легковесно и позволяет писать исходник в формате Markdown, чего не скажешь о Swagger или RAML.

По ходу работы выяснилось, что в API Blueprint удобно документировать ответы только в формате JSON, а вот с XML нужно придумывать обходные пути. Подробности - вот здесь, поскольку на сайте это выглядит более читабельно.