EI
Всё генерируется из кода
Size: a a a
2020 August 26
SL
Я тут внесу тему с автогенерацией oapi-описаний
у нас swagger-first approach. (хотя если генерить автоматически сваггер, то это не влияет почти на процесс на картинке)
GK
Из кода можно элементарно сгенерировать дефинишен (описание). Вопрос, если я правильно понял, в том, где агрегировать эти дифинишены.
GK
Как вариант, достаточно указать ссылку на дефинишен в карточке сервиса в вики
GK
Код по нему генерируется отдельной штукой в CI.
Вот если в CI ещё и автоматом ссылку вставлять в конфу, то это прям шаг вперёд
EI
Из кода можно элементарно сгенерировать дефинишен (описание). Вопрос, если я правильно понял, в том, где агрегировать эти дифинишены.
В сервисе, который умеет делать что-то дельное с ними (diff/визуальное представление/...).
Вопрос мне немного не понятен, так как для хранения есть gitlab с CI
Вопрос мне немного не понятен, так как для хранения есть gitlab с CI
SL
Вот если в CI ещё и автоматом ссылку вставлять в конфу, то это прям шаг вперёд
"конфу" - это конференция или конфлюенс ? : )
GK
"конфу" - это конференция или конфлюенс ? : )
в даном контексте - конфлюенс
AL
Шо такое sonatype если вкратце?
SL
в даном контексте - конфлюенс
как два пальца, у конфлюенса есть API, и просто генерим страницу во время отработки CI
GK
В сервисе, который умеет делать что-то дельное с ними (diff/визуальное представление/...).
Вопрос мне немного не понятен, так как для хранения есть gitlab с CI
Вопрос мне немного не понятен, так как для хранения есть gitlab с CI
да понятно, что есть гитлаб, вопрос - как быстро искать дефинишены
EI
да понятно, что есть гитлаб, вопрос - как быстро искать дефинишены
О, теперь понял
AL
В сервисе, который умеет делать что-то дельное с ними (diff/визуальное представление/...).
Вопрос мне немного не понятен, так как для хранения есть gitlab с CI
Вопрос мне немного не понятен, так как для хранения есть gitlab с CI
Мы близки к тому, что у нас требования раньше кода появлялись)
AL
поэтому по коду генерить документацию - не наш метод.
AL
Не, конечно описание API есть - но это сугубо девелоперская штука и при планировании разработки используется ими самими.
GK
Мне известен проект, в нём я не работал но немного знаю детали, в котором вообще трушный API-First, когда вообще аналитики пишут руками дефинишены. Не хочу пока комментировать, потому что не спал и думать трудно. Да и встречи скоро
EI
Мы близки к тому, что у нас требования раньше кода появлялись)
Стоимость сопровождения требований на DSL выше, если требования пишут в таблице аналитики и ниже, если нужно помогать разработчику понимать бизнес-мир.
Для меня это два разных подхода к постановке, т.е. к дизайну коммуникации в команде
Для меня это два разных подхода к постановке, т.е. к дизайну коммуникации в команде
AL
Мне известен проект, в нём я не работал но немного знаю детали, в котором вообще трушный API-First, когда вообще аналитики пишут руками дефинишены. Не хочу пока комментировать, потому что не спал и думать трудно. Да и встречи скоро
Это очень круто, когда аналитики могут из слов заказчика написать половину кода.
EI
Мне известен проект, в нём я не работал но немного знаю детали, в котором вообще трушный API-First, когда вообще аналитики пишут руками дефинишены. Не хочу пока комментировать, потому что не спал и думать трудно. Да и встречи скоро
А, ты про это и пишешь тут
SL
Шо такое sonatype если вкратце?
репозиторий артифактов.