Господа, чем документировать код? Есть огромная приложуха без единого комментария, руками будет долго. Слышал об инструменте генерирующем док исходя из кода, а не из правильно написанных комментариев. Название не помню.
если Swagger, то автоматически описанная апишка, будут описаны все URL и форматы сообщений, но без дополнительных комментарииев на методах это не будет особо читаемо