Вскоре я собираюсь разработать API-интерфейс RESTful, поэтому мне нужно описать его, чтобы другие люди могли начать использовать его с помощью клиентов.

Я немного осмотрелся, но, к сожалению, я не нашел какой-либо стандартизированной формы описания веб-сервисов RESTful. Я ищу что-то вроде JavaDoc, хотя его не нужно генерировать из какого-либо кода. Я также не говорю о чем-то вроде WADL, я скорее хочу иметь какую-то удобочитаемую документацию, которую я могу раздать.

Из-за особенностей веб-сервисов RESTful стандартизировать документацию должно быть довольно легко. Он должен просто перечислить доступные ресурсы, соответствующие URI, разрешенные методы, типы контента и описать доступные действия. Поэтому у вас есть предложения?

Спасибо заранее и приветствую