docs: add maintainers guide #7010
Conversation
|
This pull request is automatically built and testable in CodeSandbox. To see build info of the built libraries, click here or the icon next to each commit SHA. |
| - при публикации минорного релиза `x.y.0` автоматически создается ветка `x.y-stable` для патчей (например, при публикации минорной версии 6.1.0 будет создана ветка для последующих патчей 6.1-stable). | ||
| - если в `PR` указать в `Labels` значение `patch` (происходит автоматически, если название в шапке `PR` начинается с `fix`), то изменения продублируются и в `x.y-stable`. |
There was a problem hiding this comment.
Прочитав это вспомнил, что каждый раз мне больно, когда надо понять куда надо влить патч и в какой вообще ветке эти патчи искать. Или когда я виже где-то в экшенах взаимодействие с этой веткой, долго не могу понять что в ней лежит, последний минор или что, а оказывается, что последний минор с патчами.
Наверное потому, что x.y-stable мне ни о чем не говорит, и я периодически путаюсь, пока снова точно не вспомню что есть что.
Как будто бы для патчей подошло бы другое название ветки, типа x.y-patch 🙂
There was a problem hiding this comment.
Нейминг взят от GitLab Flow. x.y-stable говорит о стабильности ветки, а x.y-patch больше похоже на какой-то отдельный патч
There was a problem hiding this comment.
Нейминг взят от GitLab Flow.
x.y-stableговорит о стабильности ветки, аx.y-patchбольше похоже на какой-то отдельный патч
Это да, x.y-patch похоже на какой-то патч, а x.y-stable похоже на какой-то stable))
Понимаю, что из GitLab Flow, но сама по себе стабильная ветка мало что о себе говорит, что значит стабильная, для меня просто значит, что мы её выпустили и туда можно только хот фиксы/патчи отправлять.
В x.y-patch хотя бы слово patch на слуху и хорошо ложится на знание, что сейчас туда патч полетит, или что от туда сейчас следующий патч (версия) вылетит. И в экшенах, наверное, было бы проще на код смотреть.
Но это я придираюсь, потому что часто путаюсь. Для самого подхода такое название имеет смысл, но в прикладном смысле не очень для запоминания) Ничего менять не призываю, конечно, просто жалуюсь)
Вот вместо ссылок картинки х) Но, кажется, чтобы охватить все, нужны прям картинки всего экрана с пометкой шагами (1, 2...), куда последовательно тыкать. Вот хз, что лучше 🤔 |
No, no, no, ссылки точно оставить, интерфейс может поменяться, а ссылки хоть покажут где подробнее посмотреть. Картинки с шагами куда тыкать тоже пригодятся, но это на твоё усмотрение, вообще можно посмотреть как новый человек этот текст прочитает и у него уточнить по поводу картинок 😄 |
Мейби добавить картинок, чтобы было понятнее, куда-что нажимать?