Cabang dan tag rilis aliran Git - dengan atau tanpa awalan “v”

119

Saya telah melihat beberapa definisi yang saling bertentangan di berbagai situs web terkait aliran git. Apakah ada rekomendasi resmi atau satu sumber kebenaran?

Cabang: release-1.2.3ataurelease-v1.2.3

Tag: 1.2.3atauv1.2.3

git naming-conventions git-flow

— friederbluemle.dll
sumber

Lihat juga stackoverflow.com/questions/2006265/…

— Raedwald

Jawaban:

101

Pada dasarnya ini adalah masalah preferensi, tetapi saya lebih suka versi dengan v, karena Semver melakukannya dengan cara itu dan saya mencoba mengikuti spesifikasi itu sedekat mungkin untuk mendapatkan versi yang waras.

Itu juga membuat pemfilteran untuk Tag tersebut lebih mudah, karena Anda dapat menekan vdan kemudian TAB-kunci untuk pelengkapan otomatis: Ini akan mencantumkan semua tag (dan mungkin beberapa cabang), sedangkan ada beberapa digit yang dapat dimulai dengan tag.

Lihat juga: Apakah ada konvensi penamaan standar untuk tag git?

— TimWolla
sumber

Terima kasih, itu masuk akal. Saya rasa menarik untuk melihat bahwa proyek Git Flow itu sendiri tidak menggunakan awalan v: github.com/nvie/gitflow Karena alasan Anda dan @VonC memposting, saya masih lebih suka tag versi yang menyertakan awalan v.

— friederbluemle

Semver telah menghapus awalan v dalam versi 2.

— schmijos

Lihat: github.com/mojombo/semver/blob/master/…

— Leo

@schmijos @LeoTM - Dokumen hanya menyatakan bahwa v1.2.3 bukan versi semantik. Pertanyaannya adalah tentang tag Git. Nyatanya, semver repo masih digunakan v2.0.0sebagai tag untuk versi 2: github.com/mojombo/semver/releases/tag/v2.0.0

— friederbluemle

semver 2.0 semver.org tidak menyatakan apapun tentang tag yang dibutuhkan untuk memulai dengan awalan "v"!

— jankal

Karena v adalah singkatan dari versi, tag umumnya dinamai vX.YZ, dengan XYZ mengikuti Semantic Versioning 2.0.0 .

Hal ini memungkinkan cabang XYZ untuk hidup berdampingan dengan tag tersebut, tanpa harus berurusan dengan pesan kesalahan seperti "fatal: Nama objek yang ambigu" (seperti dalam " Nama yang Rancu dengan GIT? ").

Perhatikan bahwa tag untuk Git sendiri baru-baru ini "diadaptasi" karena alasan yang mengejutkan: lihat " Aturan" "perubahan versi kode ".

— VonC
sumber

Ketika orang menggunakan praktik terbaik seperti semver , maka mereka mungkin menggunakan sistem seperti Git Flow atau yang serupa. Itu akan mencegah benturan ref (nama tag cabang eq). Selain itu, apa yang menghalangi seseorang untuk menamai sebuah cabang vX.Y.Z? Itu bukan argumen yang terlalu banyak :)

— kaiser

semver 2.0 semver.org tidak menyatakan apapun tentang tag yang dibutuhkan untuk memulai dengan awalan "v"!

— jankal

@jankal Saya setuju. Saya hanya menyebutkan semver untuk kebijakan XYZ.

— VonC

Satu argumen kecil adalah bahwa lebih banyak orang akan mendapatkan v1.2.3daripada b1.2.3:-)

— Ciro Santilli 郝海东冠状病六四事件法轮功

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

Apakah "v1.2.3" adalah versi semantik? Tidak, "v1.2.3" bukan versi semantik. Namun, mengawali versi semantik dengan "v" adalah cara yang umum (dalam bahasa Inggris) untuk menunjukkan bahwa itu adalah nomor versi. Menyingkat "versi" sebagai "v" sering terlihat dengan kontrol versi. Contoh: git tag v1.2.3 -m "Rilis versi 1.2.3", dalam hal ini "v1.2.3" adalah nama tag dan versi semantiknya adalah "1.2.3".

— Dermaga
sumber