มีแบบแผนการตั้งชื่อมาตรฐานสำหรับแท็ก git หรือไม่ [ปิด]

ฉันเคยเห็นโครงการจำนวนมากที่ใช้v1.2.3เป็นแบบแผนการตั้งชื่อแท็กในคอมไพล์ 1.2.3ผมเคยเห็นยังใช้บางส่วน มีสไตล์การรับรองอย่างเป็นทางการหรือมีข้อโต้แย้งที่ดีสำหรับการใช้อย่างใดอย่างหนึ่ง?

เวอร์ชั่น 1.0.0 ของSemantic Versioningโดย Tom Preston-Werner of GitHub fame มีsub-Specificationที่กล่าวถึงเรื่องนี้:

ข้อกำหนดการติดแท็ก (SemVerTag)

ข้อมูลจำเพาะย่อยนี้ควรใช้หากคุณใช้ระบบควบคุมเวอร์ชัน (Git, Mercurial, SVN, ฯลฯ ) เพื่อจัดเก็บรหัสของคุณ การใช้ระบบนี้ช่วยให้เครื่องมืออัตโนมัติตรวจสอบแพ็คเกจของคุณและพิจารณาการปฏิบัติตามข้อกำหนดของ SemVer และรุ่นที่วางจำหน่าย

1. เมื่อแท็กรุ่นในระบบการควบคุมเวอร์ชันที่แท็กสำหรับรุ่นที่จะต้อง "vX.YZ" เช่น "v3.1.0"

อย่างไรก็ตามหลังจากการสนทนานี้ถูกลบและจะไม่ปรากฏในข้อมูลจำเพาะของ SemVer เวอร์ชันล่าสุดอีกต่อไป(2.0.0 ณ เวลาที่เขียน) หัวข้อสนทนาในภายหลังในสถานที่เดียวกันมีความลึกมากขึ้นและส่งผลให้เกิด"v1.2.3" รุ่นความหมายใหม่หรือไม่ การเพิ่มคำถามที่พบบ่อยในmasterสาขาของ SemVer แม้ว่าในเวลาที่เขียน (มากกว่า 2 ปีต่อมา) การเปลี่ยนแปลงนี้ยังไม่ปรากฏในข้อมูลจำเพาะที่วางจำหน่ายอย่างเป็นทางการ

ดูเหมือนว่าจะมีสองอนุสัญญาที่มีอำนาจเหนือ (สมมติว่าคุณยังปฏิบัติตามมาตรฐานที่เหมาะสมบางอย่างสำหรับการกำหนดหมายเลขรุ่นของตัวเอง):

• v1.2.3
• 1.2.3

ข้อดีของการv1.2.3ที่เอกสาร Git (และเอกสาร Mercurial) ใช้รูปแบบนั้นในตัวอย่างและ "อำนาจ" หลายอย่างเช่นเคอร์เนล LinuxและGitเองใช้ (การกำหนดความหมายแบบ Semanticใช้เพื่อใช้งาน แต่จะไม่เพิ่มอีก)

ข้อดีของการ1.2.3ที่ gitweb หรือ GitHub สามารถเสนอการดาวน์โหลด tarball หรือ zip ของแบบฟอร์มโดยอัตโนมัติpackagename-$tag.tar.gz(และฉันคิดว่ามันค่อนข้างเป็นที่ยอมรับว่าไม่ควรตั้งชื่อtarball package-v1.2.3.tar.gz) หรือคุณสามารถใช้git describeโดยตรงเพื่อสร้างหมายเลขรุ่น tarball สำหรับโครงการที่มีน้ำหนักเบาที่ไม่มีกระบวนการเปิดตัวอย่างเป็นทางการความเป็นไปได้เหล่านี้ค่อนข้างสะดวก ควรสังเกตว่า Semantic Versioning นั้นไม่ได้เป็นเพียงมาตรฐานเดียวที่เป็นที่ยอมรับในระดับสากลสำหรับการกำหนดหมายเลขเวอร์ชัน และโครงการเด่น ๆ เช่น GNOME และโครงการอื่น ๆ อีกนับไม่ถ้วนใช้การ1.2.3ตั้งชื่อแท็ก

ฉันคิดว่ามันอาจจะสายเกินไปที่จะรวบรวมตำแหน่งเหล่านี้ เช่นเคยมีความสอดคล้องและมีเหตุผล

ปรับปรุง: เป็นที่กล่าวถึงในนี้แสดงความคิดเห็น GitHub ตอนนี้มีชื่อ tarball กับ 'วี' ถอดของแท็ก

เหตุผลสำหรับการ 'v' ก่อนหน้านี้เป็นประวัติศาสตร์ SCCS ที่เก่ากว่า (cvs, rcs) ไม่สามารถแยกความแตกต่างระหว่างตัวระบุแท็กและหมายเลขการแก้ไข ตัวระบุแท็กถูก จำกัด ให้ไม่เริ่มต้นด้วยค่าตัวเลขเพื่อให้สามารถตรวจพบหมายเลขการแก้ไข

ไม่ใช่ที่ฉันรู้
แต่ Git จะไม่อนุญาตให้ใช้แท็กและสาขาที่มีชื่อเดียวกันในเวลาเดียวกันดังนั้นหากคุณมีสาขา " 1.1" สำหรับ1.1งานอย่าใส่แท็ก " 1.1" ใช้เป็นตัวอย่าง " v1.1"

ผู้จัดการแพคเกจใหม่แนะนำให้ติดแท็กเวอร์ชันโดยไม่มีคำนำหน้าv(เช่นผู้แต่งสำหรับโครงการ PHP) SemVer 2.0ไม่มีอะไรเกี่ยวกับสเปคแท็ก มันทำโดยเจตนาเนื่องจากหลีกเลี่ยงความขัดแย้ง อย่างไรก็ตามขอแนะนำให้เพิ่มคำนำหน้าvในเอกสารและข้อความอ้างอิง เป็นรูปแบบตัวอย่างv1.0.4แทนที่จะเป็นแบบเต็มversion 1.0.4หรือver. 1.0.4เพียงพอและ verbose และสง่างามในเอกสาร

เราใช้ branch และ tags สำหรับงานเฉพาะรุ่นตามด้วยรุ่นจริงตามลำดับ:

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

นักพัฒนาทุกคนตัดสินใจอย่างรอบคอบว่างานที่พวกเขากำลังจะทำนั้นมีผลบังคับใช้กับผู้เชี่ยวชาญหรือไม่หรือเกี่ยวข้องกับสาขาด้วย คุณสามารถเห็นได้ว่าการเปลี่ยนแปลงที่ทำกับสาขานั้นจะถูกรวมกลับคืนบนต้นแบบ แต่การเปลี่ยนแปลงบางอย่างในต้นแบบจะไม่ดำเนินการกับสาขา (นั่นคือสิ่งที่ไม่ได้มีไว้สำหรับการเปิดตัว 1.6 ในตัวอย่างนี้)

เมื่อเราพร้อมที่จะวางจำหน่ายเราแท็กแท็กแล้วรวมกลับเป็นครั้งสุดท้ายและเราตั้งชื่อแท็กที่มีชื่อเดียวกันกับสาขา แต่มีตัวระบุพิเศษเกี่ยวกับเวอร์ชันเฉพาะเช่น "1.6 รีลีส" หรือ "1.6-beta" หรือ "1.6-rc2", และอื่น ๆ

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

ฉันไม่รู้มาตรฐานใด ๆ ฉันเพียงแค่เลือกชื่อแท็กของฉันเช่นที่ฉันสามารถติด

VERSION = `git describe --tags`

ในสคริปต์การสร้างของฉัน ดังนั้นแบบแผนการตั้งชื่อแท็กจริง ๆ แล้วขึ้นอยู่กับแบบแผนการตั้งชื่อเวอร์ชันของโครงการ

ไม่มีเป็นหนึ่งในวิธีที่ดีที่สุดฉันรู้ นี่คือลิงค์บางส่วน:

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

โดยทั่วไปการกำหนดเวอร์ชัน ( 0.0.1,, v0.2.1... ) อาจจับมือกับการติดตามปัญหาบางอย่างอาจถือเป็นแนวทางที่น่าเชื่อถือ (.. ถึงแม้ว่าฉันมักจะใช้vชื่อแท็กที่ได้รับการแก้ไข .. ดูคำตอบ @VonC ด้วย)