вручную? Как потом делать доку и гарантировать то, что она будет соответствовать валидаторам и т.п.? Чем не угодил go-swagger?
Обязательно ознакомлюсь с go-swagger, во-первых я не знал о нём, а во-вторых, думаю что мне как новичку стоит вручную всё писать, для начала
типа сначала писать спеку сваггера 2 года, а потом генерить хендлеры? и если что-то меняешь, то меняешь спеку и перегенеришь хендлеры?
Вы напишете API, а потом фронтендер потребует дать ему документацию к API. Скорее всего, вы напишете её вручную. Гарантий, что она соответствует коду, никакой
Согласен, писать документацию будет сложно
ну если до 5 методов то можно и самому
"типа сначала писать спеку сваггера 2 года" - ну прото-файлы ты же пишешь и ничего)
я не пишу 🙂 я не юзаю grpc
А как у тебя сервисы данными обмениваются?
rabbitmq/nuts, json rpc, rest api
Ну тогда вернёмся к rest api: как ты его документируешь?
А как он формируется?
// Patch // @Summary Update User List // @Tags Users // @Param input body UpdateListDTO true "body" // @Accept json // @Success 204
Я так в одном пыховом проекте сделал - в итоге он превратился в ад. В контроллере кода на 600 строк, а с докой такой он раздулся почти до 2 тысяч (!!!) строк
в пхппхпхпхп может быть что угодно )
Не, тут не в пыхе дело. А в том, что 100500 строк комментов для генерации swagger
https://i.imgur.com/sL4SwZ7.png
Ну так можно, да.
Потому что документация в коде антипаттерн?
если это считалось бы антипаттерном, то должно быть объяснение почему это антипаттерн
А ты много видишь документации в коде? Или может видишь документацию в документации? 🙂 Не путайте с комментариями, таки
Впервые слышу. И то не дока, а аннотации для генерации доки
Аххахаахазахахазц, а как по твоему доки на pub, go docs генерируются ???)
А как юзать другие веб фреймворки?
Для чего?) В том же gin-gonic один роутинг по сути и всё
Ну некоторые вроде пошустрее работают, чем стандартная либа
Если приложение запущено не в единственном инстансе (обычно это так), то это вообще никакой роли не играет
Обсуждают сегодня