Как вы документируете API?
для внутреннего потребления - генерируем документацию по комментариям.
для внешнего потребления - первый пункт доводится до нужного состояния специальными людьми.
Но, есть ли сервисы или решения, которые помогают в этом?
doxygen?
swagger | blueprint | RAML (for REST API)?
single sourcing technical documentation?