Инструменты документации для API RPC

Существует множество хороших инструментов для исходного кода и документации API ( doxygen , Headerdoc , ] Сфинкс , и это лишь некоторые из них). Однако ни один из них не кажется особенно подходящим для создания документации для API, предоставляемых через интерфейс RPC (если у вас есть рекомендации о том, как синтезировать документацию по RPC API с помощью этих инструментов, обязательно предложите это).

Меня особенно интересуют инструменты документации, которые хотя бы частично поддерживают JSON и AMQP , но вопрос также касается таких вещей, как Protobuf , Экономичность , XML-RPC и любые предложения по инструментам, которые работают с этими технологиями, по крайней мере, дадут мне место для начала.

Честно говоря, мне еще предстоит увидеть качественную документацию для любого интерфейса RPC (либо созданного вручную или с помощью инструмента), и я просто надеюсь, что это потому, что разработчики ленивы, а не потому, что инструментов не существует.

14
задан albert 23 December 2018 в 10:32
поделиться