IN
Size: a a a
2020 June 01
D
а. ну тогда тебе ок будет
IN
я откозался от всяких там APIpie потому что мне не нравилось что все файлы становятся огромными, и DRY принцип далек от такого подхода и как понимаю swagger blocks тоже самое
AI
пробовал. не советую. тесты и документация в одной реализации - плохая идея
Отличная идея так то. Вот отдельно держать - отвратительно.
AI
я откозался от всяких там APIpie потому что мне не нравилось что все файлы становятся огромными, и DRY принцип далек от такого подхода и как понимаю swagger blocks тоже самое
Они реально становятся огромными и не всегда актуальны
D
я откозался от всяких там APIpie потому что мне не нравилось что все файлы становятся огромными, и DRY принцип далек от такого подхода и как понимаю swagger blocks тоже самое
какие именно файлы? в swagger-blocks ты разделяешь endpoint-ы по разным файлам, отдельно схемы
AI
какие именно файлы? в swagger-blocks ты разделяешь endpoint-ы по разным файлам, отдельно схемы
Отлично, и забываешь их поменять потом
AI
Кто-нибудь пробовал rswag для документации апи?
Просто раньше юзал rspec json documentation, а своггер то выглядит интереснее, да и удобнее, так это?
Просто раньше юзал rspec json documentation, а своггер то выглядит интереснее, да и удобнее, так это?
Мне понравилось, оч красиво выходит 🙂
AI
Сваггер+Грейп=oneLove
IN
Мне понравилось, оч красиво выходит 🙂
Каеф, спасиб)
D
Отличная идея так то. Вот отдельно держать - отвратительно.
мне не нравится dsl rswag. очень непрозрачно как-то реализовано
AI
мне не нравится dsl rswag. очень непрозрачно как-то реализовано
возможно. Но подход хороший
IN
мне не нравится dsl rswag. очень непрозрачно как-то реализовано
Вроде как в оф апи для дотнета почти такой же
IN
И вроде как от туда он пошёл, да?
D
И вроде как от туда он пошёл, да?
хз. ничего не знаю про .net и не хочу знать)
D
возможно. Но подход хороший
если судить с точки зрения того, что это помогает предотвращать расхождение тестов и доков то да
AI
если судить с точки зрения того, что это помогает предотвращать расхождение тестов и доков то да
угу
AI
В моей практике доки очень часто забывают обновлять.
AI
Вон в том же Rust'е можно доктесты делать. Куски кода которые есть в документации гоняются как тесты. Чтобы проверять актуальность документации.
AI
Также и с тестами, очень легко рассинхронизироваться. А в тестах наоборот довольно сложно не актуализировать