Có một quy ước đặt tên tiêu chuẩn cho các thẻ git? [đóng cửa]

Tôi đã thấy rất nhiều dự án sử dụng v1.2.3làm quy ước đặt tên cho các thẻ trong git. Tôi cũng đã thấy một số sử dụng 1.2.3. Có một phong cách chính thức được chứng thực, hoặc có bất kỳ lý lẽ tốt để sử dụng một trong hai?

Phiên bản 1.0.0 của Phiên bản ngữ nghĩa , bởi Tom Preston-Werner của GitHub nổi tiếng, đã có một đặc tả phụ giải quyết vấn đề này:

Đặc tả gắn thẻ (SemVerTag)

Thông số phụ này NÊN được sử dụng nếu bạn sử dụng hệ thống kiểm soát phiên bản (Git, Mercurial, SVN, v.v.) để lưu trữ mã của bạn. Sử dụng hệ thống này cho phép các công cụ tự động kiểm tra gói của bạn và xác định các phiên bản phát hành và tuân thủ SemVer.

1. Khi gắn thẻ phát hành trong hệ thống kiểm soát phiên bản, thẻ cho phiên bản PHẢI là "vX.YZ", vd: "v3.1.0" .

Tuy nhiên, sau khi thảo luận, phần này đã bị xóa và không còn xuất hiện trong phiên bản mới nhất của thông số SemVer (2.0.0 tại thời điểm viết). Một chủ đề thảo luận sau đó ở cùng một nơi đã đi sâu hơn và dẫn đến một "v1.2.3" mới là một phiên bản ngữ nghĩa? được thêm vào Câu hỏi thường gặp trong masterchi nhánh của SemVer , mặc dù tại thời điểm viết (hơn 2 năm sau), thay đổi này vẫn chưa xuất hiện trong thông số kỹ thuật được phát hành chính thức.

Dường như có hai quy ước thống trị (giả sử bạn cũng tuân thủ một số tiêu chuẩn hợp lý để đánh số bản phát hành):

• v1.2.3
• 1.2.3

Ưu điểm của v1.2.3là tài liệu Git (và cả tài liệu Mercurial) sử dụng định dạng đó trong các ví dụ của nó và một số "cơ quan" như nhân Linux và chính Git sử dụng nó. ( Phiên bản ngữ nghĩa được đề cập được sử dụng để sử dụng nhưng không còn nữa.)

Ưu điểm của 1.2.3gitweb hoặc GitHub có thể tự động cung cấp bản tải xuống tarball hoặc zip của biểu mẫu packagename-$tag.tar.gz(và tôi nghĩ rằng nó hoàn toàn không được đặt tên là không nên đặt tên cho một tarball package-v1.2.3.tar.gz). Ngoài ra, bạn có thể sử dụng git describetrực tiếp để tạo số phiên bản tarball. Đối với các dự án nhẹ mà không có quy trình phát hành chính thức, những khả năng này có thể khá thuận tiện. Cũng cần lưu ý rằng Phiên bản ngữ nghĩa không phải là tiêu chuẩn duy nhất hoặc được chấp nhận phổ biến cho việc đánh số phiên bản. Và các dự án đáng chú ý như Gnome cũng như vô số dự án khác sử dụng 1.2.3cách đặt tên thẻ.

Tôi nghĩ có lẽ đã quá muộn để củng cố các vị trí này. Như mọi khi, hãy kiên định và có ý nghĩa.

Cập nhật: Như đã đề cập trong nhận xét này , GitHub hiện cung cấp một tên tarball với 'v' bị tước khỏi thẻ.

Lý do cho 'v' trước đó là lịch sử. SCCS cũ hơn (cvs, rcs) không thể phân biệt giữa số nhận dạng thẻ và số sửa đổi. Số nhận dạng thẻ bị hạn chế không bắt đầu bằng giá trị số để có thể phát hiện số sửa đổi.

Không phải là tôi biết.
Nhưng Git sẽ không cho phép một thẻ và một nhánh cùng tên cùng một lúc, vì vậy nếu bạn có một nhánh " 1.1" cho 1.1công việc, đừng đặt thẻ " 1.1", hãy sử dụng ví dụ " v1.1"

Các nhà quản lý gói mới khuyên nên gắn thẻ các phiên bản không có tiền tố v(như trình soạn thảo cho các dự án PHP). SemVer 2.0 không có gì về đặc tả thẻ. Nó được thực hiện có chủ ý do tránh xung đột. Tuy nhiên, nên thêm tiền tố vvào tài liệu và tài liệu tham khảo. Như định dạng ví dụ v1.0.4thay vì đầy đủ version 1.0.4hoặc ver. 1.0.4đủ dài dòng và thanh lịch trong tài liệu.

Chúng tôi sử dụng các nhánh và thẻ cho công việc dành riêng cho phát hành, theo sau là bản phát hành thực tế, tương ứng:

o---o-----o---o---o--- ...   master
     \   /       /
      \ /       /
       o-------o--- ...      1.6 branch

Mọi nhà phát triển đưa ra quyết định tinh thần về việc công việc họ sắp cam kết có thể áp dụng chỉ để làm chủ hay nếu nó cũng liên quan đến chi nhánh. Bạn có thể thấy rằng những thay đổi được thực hiện cho nhánh được hợp nhất trở lại trên master, nhưng một số thay đổi trên master sẽ không bao giờ đi trên nhánh (nghĩa là những thay đổi không dành cho phiên bản 1.6, trong ví dụ này).

Khi chúng tôi sẵn sàng phát hành, chúng tôi gắn thẻ và sau đó hợp nhất lại lần cuối và chúng tôi đặt tên cho thẻ có cùng tên với chi nhánh, nhưng với một định danh bổ sung về phiên bản cụ thể của nó, ví dụ: "1.6-phát hành" hoặc "1.6-beta" hoặc "1.6-RC2", et cetera.

... ------o---o---o--o---o--- ...   master
         /       /
        /       /
... ---o------(*)--- ...      1.6 branch
          1.6-release

Tôi không biết bất kỳ tiêu chuẩn. Tôi chỉ cần chọn tên thẻ của mình để tôi có thể dán

VERSION = `git describe --tags`

trong các kịch bản xây dựng của tôi. Vì vậy, quy ước đặt tên thẻ thực sự phụ thuộc vào quy ước đặt tên phiên bản của dự án.

Không có ai thực hành tốt nhất mà tôi biết. Dưới đây là một số liên kết:

• http://web.elctech.com/?p=79
• http://reinh.com/blog/2009/03/02/a-git-workflow-for-agile-teams.html#production-tagging

Nói chung, phiên bản ( 0.0.1,, v0.2.1...) có thể bắt tay với một số theo dõi vấn đề có thể được coi là một cách tiếp cận hợp lý. (.. mặc dù tôi thường sử dụng vtên thẻ -prefixed .. xem thêm câu trả lời @VonC)