Коллеги, привет! Поделитесь, пожалуйста, опытом — какие плюсы и минусы хранения

Fox Mulder
Самая распространённая проблема — очередь на слиян...

можно поподробней? я не понял, и у меня родилось несколько несвязанных объяснений твоих слов

0

25.08.2023

Mikhail Mironov

rJIynbIu` KOT
можно поподробней? я не понял, и у меня родилось н...

Если команда начинает изменять один и тот же файл, то при мерже будут возникать конфликты, которые надо уметь решать.

0

25.08.2023

Дарья Курнаева (Чернавина)

vnv rus
А минусы?

Например, описанное в доке может относиться к нескольким проектам, тогда логичнее завести отдельный репозиторий под документацию. В противном случае будут дубли в каждом проекте. Ну и предполагаю, что попроектное хранение не оч вписывается в концепцию единого источника.

0

25.08.2023

rJIynbIu` KOT
можно поподробней? я не понял, и у меня родилось н...

Это известная проблема монорепозиториев, когда все коммиты сбрасываются в одну репу, то формируется очень большое кол-во деревьев. И если у нас большое кол-во проектов\команд пушит в эту репу, то возникает временной лаг. Когда твой коммит становится в очередь. Находясь в очереди твой коммит может устареть и тогда тебе надо отменить его, ребейзнуть локально до актуального стейта и снова запушить. В очень больших командах с монорепозиторием в моей практике было, что коммит мог висеть в очереди и час. Плюс, не забываем, что коммит надо апрувнуть. На апрув, а точнее очередь на слияние, тоже может быть очередь. Поэтому, я для себя понял, что если команда большая, то монорепа не лучший выбор.

0

25.08.2023

Fox Mulder
Это известная проблема монорепозиториев, когда все...

> все коммиты сбрасываются в одну репу, то формируется очень большое кол-во деревьев именно коммиты, а не PR? или в данном случае это одно и тоже? у нас сейчас только для репозитория документации висит 500 незакрытых PR, то есть они в работе или ждут апрува и вливания и я не вижу здесь никаких проблем, так как люди не правят одно и то же, то есть не выполняют одинаковых задач, а конфликты если и появляются, то относятся к разным вещам (хоть и в одном файле) и легко решаются > В очень больших командах с монорепозиторием в моей практике было, что коммит мог висеть в очереди и час. у нас PR с изменения может и месяц провисеть, ожидая апрува и вливания, и в этом я тоже не вижу проблем, даже через месяц конфликты редки, а если и есть, то легкорешаемые

0

25.08.2023

rJIynbIu` KOT
про обычный

про обычный

0

25.08.2023

Алексей Таразанов

Про обычный все справедливо. А Фокс про моно вещает. Там есть нюансы, насколько я могу судить.

0

25.08.2023

rJIynbIu` KOT
> все коммиты сбрасываются в одну репу, то формиру...

Да, конечно, я приравнял коммиты с PR\MR в данном контексте. То что у вас незакрытые таски висят по месяцу — уникальный процесс именно для вашей компании. Если вы работаете по недельным спринтам, то задержка в закрытии задач неприемлема. Особенно, если у вас на таски привязан и KPI.

0

25.08.2023

Fox Mulder
Да, конечно, я приравнял коммиты с PR\MR в данном ...

понял, кажется у нас очень хороший уникальный процесс)

0

25.08.2023

rJIynbIu` KOT
понял, кажется у нас очень хороший уникальный проц...

Тем более смотрите. Вот такая ситуация. У вас 20 микросервисов в монорепе и согласно релизной концепции, каждый микросервис обзаводится релизной веткой только если он не ломает работу остальных 19 микросервисов. И вот вы либо бежите вперед или отстаёте; отсюда и возникает проблема в актуальном состоянии всего продукта. Ну и если у вас много этих микросервисов, то рано или поздно, ваш git станет захлёбываться от коммитов (тут именно про них) в рамках одной монорепы. Любое обновление состояния (даже локального) начинает занимать очень большое время. Я знаю в Гугле монорепа, но у них своя система контроля версий, а как и что, я ессно не знаю.

0

25.08.2023

Eduard Tibet

Наверное, имеет смысл уточнить, какая именно документация. Допустим, документация, которая после коммита пушится и заливается на продакшн - это одно. Документация, которая просто "живет в себе" (например, для команды) - это другое. Т.е. входных данных изначально должно быть больше, ибо непонятно, о чем речь. Поэтому ответы выше по треду имеют свою ценность, но только по отношению к конкретной ситуации, которую _предполагал_ автор каждого этого ответа.

0

25.08.2023

Tatiana Автор вопроса

Eduard Tibet
Наверное, имеет смысл уточнить, какая именно докум...

Спасибо за уточнение! Вопрос был про документацию для продакшна.

0

25.08.2023

Anna Ryutina

Всегда можно восстановить если потеряется или потрется текст (такое бывает)

0

25.08.2023

Eduard Tibet

Tatiana
Спасибо за уточнение! Вопрос был про документацию ...

Тогда следует уточнить вопрос про релизные циклы. Ибо, допустим, когда релизный цикл документации один, а выпуск продукта - другой встает вопрос того, что в дереве реальная каша. Да, можно встроить сборку отдельно по коду и по исходникам документации - допустим, когда делается фикс к документации, но код остается нетронутым (например,Gitlab CI это позволяет). Но тогда придется в одном дереве держать разные теги например, 2.1.3, 2.1.3-docs - а бранчей вообще будет огромное количество, Насколько это удобно - вопрос использующих это дерево.

0

25.08.2023

Fox Mulder
Это известная проблема монорепозиториев, когда все...

Интересуюсь этой темой, но пока не понимаю жаргона этой области. Для начала, монорепа - это репозиторий, в котором хранится код вместе с документацией?

0

26.08.2023

Vasil Bar
Интересуюсь этой темой, но пока не понимаю жаргона...

Вообще, монорепозиторий это когда вся компания хранит весь код буквально в одном репозитории. Для этого используют специальные системы контроля версий (не гит). Применяют в некоторых крупных компаниях, точно знаю про Яндекс и Фейсбук.

0

26.08.2023

Nick Volynkin
Вообще, монорепозиторий это когда вся компания хра...

Документируете вы продукт, а продукт может состоять из множества приложений/сервисов/библиотек, код которых разнесен по множеству репозиториев.

0

26.08.2023

Bogdan Larson

Какие плюсы у такого подхода? И минусы? Про минусы, как понимаю, можно долго ждать мержа?

0

26.08.2023

Nick Volynkin
Вообще, монорепозиторий это когда вся компания хра...

Спасибо! А документация при этом тоже может там же храниться, как следует из обсуждения, предшествующего посту к которому я задал вопрос?

0

26.08.2023

Vasil Bar
Спасибо! А документация при этом тоже может там ж...

Всё в одном репозитории. Вообще все, все продукты, все вспомогательные штуки, тесты, документация. Когда вы приедете работать в такую компанию, вас научат. До тех пор можно об этом не беспокоиться:)

0

26.08.2023

Nick Volynkin
Всё в одном репозитории. Вообще все, все продукты,...

Обучаться рад, не боюсь этого, обучаюсь быстро. Но они жев вакансиях требуют опыт работы и

0

26.08.2023

Vasil Bar
Обучаться рад, не боюсь этого, обучаюсь быстро. Но...

Никто не требует в вакансиях навык работы с монорепозиторием

0

26.08.2023

Nick Volynkin
Никто не требует в вакансиях навык работы с моноре...

Работы с git.

0

26.08.2023

Vasil Bar
Работы с git.

А, гит полезен, да.

0

26.08.2023

Уточните вопрос, пожалуйста. С чем мы это сравниваем: с хранением доки в отдельном репозитории или с другими инструментами для документации?

0

26.08.2023