Size: a a a

Software Design/Architecture/Zen

2021 February 09

КГ

Константин Грачев... in Software Design/Architecture/Zen
Или спеку на ходу может кто-то дописывать, в отдельной репе писарю может быть проще
источник

k

knopkod4v in Software Design/Architecture/Zen
Константин Грачев
а. Да хз. В ряде ситуаций так может быть удобнее. Типа тем кому нужна спека могут не иметь доступа к коду апи
это уже к организационным моментам наверное
источник

k

knopkod4v in Software Design/Architecture/Zen
Константин Грачев
Или спеку на ходу может кто-то дописывать, в отдельной репе писарю может быть проще
а это решается отдельной веткой в гит-е по идее
источник

k

knopkod4v in Software Design/Architecture/Zen
хотя я не уверен за счёт чего проще 🤔
источник

КГ

Константин Грачев... in Software Design/Architecture/Zen
knopkod4v
а это решается отдельной веткой в гит-е по идее
Как по мне ветки в гите ничего кроме создания merge hell'ов не создают)
источник

k

knopkod4v in Software Design/Architecture/Zen
Константин Грачев
Как по мне ветки в гите ничего кроме создания merge hell'ов не создают)
если каплинг высокий, то да
но это не проблема гит-а или веток
источник

k

knopkod4v in Software Design/Architecture/Zen
ну или ещё вариант - в организации не могут договориться кто какую фичу делает. Я правда никогда такого не видел
источник

MG

Max Grom in Software Design/Architecture/Zen
У нас спека возле модуля. На уровне DoD есть правило: сделал изменения затрагивающие спеку - актуализируй спеку. На код-ревью это как поинт что бы не упустить. Вроде никаких проблем
источник

АГ

Алексей Гевондян... in Software Design/Architecture/Zen
генерация кода из спеки - норм. генерация спеки из кода - это портянки с комментами в коде, в объеме х2 к коду, для генерации спеки. т.е. спека в коде - такое себе чот
источник

BT

Bohdan Turchyk in Software Design/Architecture/Zen
knopkod4v
побежать я всегда успею)
да и я в целом не работаю на этом проекте
скорее накидываю им на вентилятор.
Так сказать сторонний диванный консультант
вот так жаловался, что ничего не знаешь, а теперь консультант)
источник

DT

Dmitriy Tkachenko in Software Design/Architecture/Zen
knopkod4v
халп
простой (ХЗ, на самом деле не очень) вопрос. Стоит ли держать спеку (напр. OAS) в отдельной от эндпоинтов, которые она описывает, репе?
Ну тип если рассмотреть монорепо-проект - часто всю спеку полностью кладут в отдельную папку. У нас проблема в том, что хотят запихнуть спеку по всем эндпоинтам (которые в разных репах) в одну общую репу документации.
Мне кажется, что с точки зрения кохижена и каплинга лучше всего пихать спеку к тому модулю, который спека описывает, это упростит изменения(не надо делать коммит в 2 репозитория по 1 фиче), удобнее будет подключать валидацию по json-schema.
Кто как делает?
1 bounded context = 1 contract
источник

k

knopkod4v in Software Design/Architecture/Zen
Bohdan Turchyk
вот так жаловался, что ничего не знаешь, а теперь консультант)
тут важное уточнение - диванный консультант) Отличие в количестве слов 1, а разница по факту большая)
источник

k

knopkod4v in Software Design/Architecture/Zen
точно так же нифига не знаю =\
источник

MM

Maksim Masiukevich in Software Design/Architecture/Zen
knopkod4v
точно так же нифига не знаю =\
источник

k

knopkod4v in Software Design/Architecture/Zen
Dmitriy Tkachenko
1 bounded context = 1 contract
наверное мы хотим nice and even 🤔
источник

k

knopkod4v in Software Design/Architecture/Zen
Max Grom
У нас спека возле модуля. На уровне DoD есть правило: сделал изменения затрагивающие спеку - актуализируй спеку. На код-ревью это как поинт что бы не упустить. Вроде никаких проблем
респект
источник

SB

Sergei Baikin in Software Design/Architecture/Zen
knopkod4v
халп
простой (ХЗ, на самом деле не очень) вопрос. Стоит ли держать спеку (напр. OAS) в отдельной от эндпоинтов, которые она описывает, репе?
Ну тип если рассмотреть монорепо-проект - часто всю спеку полностью кладут в отдельную папку. У нас проблема в том, что хотят запихнуть спеку по всем эндпоинтам (которые в разных репах) в одну общую репу документации.
Мне кажется, что с точки зрения кохижена и каплинга лучше всего пихать спеку к тому модулю, который спека описывает, это упростит изменения(не надо делать коммит в 2 репозитория по 1 фиче), удобнее будет подключать валидацию по json-schema.
Кто как делает?
У нас отдельно лежит но во время деплоя заливается на s3 откуда уже на специальном адресе со статикой подтягивается и JS показывается как надо
источник

SB

Sergei Baikin in Software Design/Architecture/Zen
Sergei Baikin
У нас отдельно лежит но во время деплоя заливается на s3 откуда уже на специальном адресе со статикой подтягивается и JS показывается как надо
Я к тому что можно и вашим и ихним. Во время сборки объеденять
источник

k

knopkod4v in Software Design/Architecture/Zen
Sergei Baikin
У нас отдельно лежит но во время деплоя заливается на s3 откуда уже на специальном адресе со статикой подтягивается и JS показывается как надо
а на бек как?
источник

SB

Sergei Baikin in Software Design/Architecture/Zen
knopkod4v
а на бек как?
не понял что значит на бэк
источник