Odgałęzienia i tagi wydania Git Flow - z lub bez przedrostka „v”

119

Widziałem wiele sprzecznych definicji na różnych stronach internetowych związanych z git flow. Czy istnieje oficjalne zalecenie lub jedno źródło prawdy?

Oddziały: release-1.2.3lubrelease-v1.2.3

Tagi: 1.2.3lubv1.2.3

git naming-conventions git-flow friederbluemle
źródło
Zobacz także stackoverflow.com/questions/2006265/…
Raedwald

Odpowiedzi:

101

Cóż, w zasadzie to kwestia preferencji, ale wolę wersję z rozszerzeniem v, ponieważ Semver robi to w ten sposób i staram się podążać za tą specyfikacją jak najbliżej, aby uzyskać rozsądną wersję.

Ułatwia to również filtrowanie dla tych tagów, ponieważ możesz nacisnąć, va następnie klawisz TAB-klawisz do autouzupełniania: Spowoduje to wyświetlenie wszystkich tagów (i może kilku gałęzi), podczas gdy istnieje kilka cyfr, od których tag mógłby się zaczynać.

Zobacz też: Czy istnieje standardowa konwencja nazewnictwa dla tagów git?

TimWolla
źródło
2
Dzięki, to ma sens. Myślę, że interesujące jest to, że sam projekt Git Flow nie używa przedrostków v: github.com/nvie/gitflow Z powodów, które opublikowaliście wraz z @VonC, nadal wolę tagi wersji, które zawierają prefiks v.
friederbluemle
49
Semver usunął prefiks v w wersji 2.
schmijos
1
Zobacz: github.com/mojombo/semver/blob/master/…
Leo
9
@schmijos @LeoTM - Dokument stwierdza tylko, że wersja 1.2.3 nie jest wersją semantyczną. Pytanie dotyczyło tagów Git. W rzeczywistości repozytorium semver nadal używa v2.0.0jako tagu dla wersji 2: github.com/mojombo/semver/releases/tag/v2.0.0
friederbluemle
1
semver 2.0 semver.org nie podaje nic na temat znaczników potrzebnych do rozpoczęcia przedrostka „v”!
jankal
30

Ponieważ v oznacza wersję, tagi są generalnie nazywane vX.YZ, gdzie XYZ jest zgodne z wersją semantyczną 2.0.0 .

Dzięki temu gałęzie XYZ mogą współistnieć z tymi znacznikami, bez konieczności zajmowania się komunikatem o błędzie, takim jak „fatal: Niejednoznaczna nazwa obiektu” (jak w przypadku „ Niejednoznaczne nazwy z GIT? ”).

Zwróć uwagę, że tagi dla samego Gita zostały niedawno „przystosowane” z zaskakującego powodu: zobacz „Zasady zmiany wersji kodu ”.

VonC
źródło
1
Kiedy ludzie używają najlepszych praktyk, takich jak semver , prawdopodobnie używają systemu takiego jak Git Flow lub podobnego. To zapobiegłoby temu zderzeniu refs (nazwa znacznika branch eq). Poza tym, co powstrzymałoby w takim razie przed nadaniem nazwy gałęzi vX.Y.Z? To naprawdę nie jest taki argument :)
kaiser
3
semver 2.0 semver.org nie podaje nic na temat znaczników potrzebnych do rozpoczęcia przedrostka „v”!
jankal
@jankal Zgadzam się. Wspomniałem o semver tylko dla polityki XYZ.
VonC
Jednym z drobnych argumentów jest to, że otrzyma więcej osób v1.2.3b1.2.3
Drobnym
3

https://semver.org/#is-v123-a-semantic-version

Czy „v1.2.3” jest wersją semantyczną? Nie, „v1.2.3” nie jest wersją semantyczną. Jednak poprzedzanie wersji semantycznej przedrostkiem „v” jest powszechnym sposobem (w języku angielskim) wskazania, że ​​jest to numer wersji. Skracanie „wersja” jako „v” jest często widoczne w przypadku kontroli wersji. Przykład: tag git v1.2.3 -m „Wersja wydania 1.2.3”, w którym to przypadku „v1.2.3” to nazwa tagu, a wersja semantyczna to „1.2.3”.

Molo
źródło