วิธีตั้งชื่อโครงการของคุณ
- project_name-7.25-1.0 อัลฟา
- project_name-7.25-1.0-beta1
- project_name-7.25-1.0-dev2
- project_name-7.25-1.0-RC3
- project_name-7.25-1.0-stable4
- project_name-7.25-1.0-unstable5
ปฏิบัติตามแนวทางปฏิบัติที่ดีที่สุด
วิธีตั้งชื่อโครงการของคุณ
ปฏิบัติตามแนวทางปฏิบัติที่ดีที่สุด
คำตอบ:
ดู Drupal.org สำหรับการประชุมการเปิดตัวการตั้งชื่อและ explantion เพิ่มเติม
สรุป:
rc = Release Candidate ที่ผู้เขียนเห็นว่าเหมาะสมสำหรับสถานที่ผลิต
rc : ควรมีการสร้างตัวเลือกการเปิดตัวเมื่อมีการรายงานปัญหาข้อบกพร่องที่สำคัญทั้งหมดในคิวปัญหาของโครงการ แท็กนี้ควรใช้เมื่อนักพัฒนาเชื่อว่าโครงการพร้อมใช้งานในไซต์การผลิต ไม่มีวิธีปฏิบัติที่ดีที่สุดอย่างเป็นทางการสำหรับระยะเวลาโครงการที่ควรจะเป็นผู้สมัครรุ่นก่อนที่จะสร้างรุ่น 0.0 อย่างเป็นทางการ แต่ขอแนะนำว่าควรออกอย่างน้อยหนึ่งเดือนด้วยสถานะที่กำหนดเป็น "ต้องการการตรวจสอบ" หากมีบางสิ่ง (เช่นรายงานข้อผิดพลาดที่สำคัญใหม่) ทำให้จำเป็นต้องสร้างการเปิดตัวใหม่ในช่วงเวลานี้ผู้สมัครรุ่นใหม่ควรถูกสร้างขึ้นและสิ่งนี้จะยังคงอยู่อย่างน้อยหนึ่งเดือนโดยมีสถานะเป็น "ต้องการการตรวจสอบ"
มันก็โอเคที่จะแท็กโมดูล "rc" ที่มีปัญหาการร้องขอคุณสมบัติที่โดดเด่น ผู้เขียนโมดูลไม่จำเป็นต้องตอบสนองทุกการร้องขอคุณสมบัติผู้ใช้ของโมดูลโพสต์ไปยังคิวปัญหา
นี่คือคำอธิบายของแท็กปล่อยอื่น ๆ ที่อนุญาต:
ไม่เสถียร : โครงการไม่อยู่ในสถานะมั่นคง อาจมีข้อผิดพลาดที่ไม่ได้รวมจำนวนมากรวมถึงปัญหาความปลอดภัย API อาจเปลี่ยนแปลงได้โดยไม่ต้องแจ้งให้ทราบล่วงหน้า สกีมาฐานข้อมูลอาจเปลี่ยนแปลงได้โดยไม่ต้องhook_update_N
ใช้งาน การใช้งานและ API อาจไม่ได้รับการบันทึกไว้ การติดตั้งรีลีสใหม่ที่ไม่เสถียรทำให้เกิดการถอนการติดตั้งโปรเจ็กต์จึงสูญเสียข้อมูลทั้งหมด สำหรับผู้ที่ต้องการดูตัวอย่างก่อนหน้าของโครงการเท่านั้น ยังไม่เหมาะสำหรับการพัฒนาร่วมกัน
อัลฟ่า : ข้อผิดพลาดที่รายงานส่วนใหญ่ได้รับการแก้ไข แต่อาจยังมีปัญหาที่ทราบดีเด่นอย่างร้ายแรงรวมถึงปัญหาด้านความปลอดภัย โครงการไม่ผ่านการทดสอบอย่างละเอียดดังนั้นอาจมีข้อบกพร่องที่ไม่ทราบจำนวนมาก มี README.txt / README.md ที่จัดทำเอกสารโครงการและ API (ถ้ามี) API และ DB schema อาจใช้งานได้ แต่การเปลี่ยนแปลงทั้งหมดเหล่านี้จะถูกรายงานในบันทึกประจำรุ่นและhook_update_N
มีการใช้งานเพื่อเก็บรักษาข้อมูลผ่านการเปลี่ยนแปลงแบบแผน แต่ไม่มีเส้นทางการอัปเกรด / อัปเดตอื่น ๆ ไม่เหมาะสำหรับสถานที่ผลิต กลุ่มเป้าหมายคือนักพัฒนาที่ต้องการมีส่วนร่วมในการทดสอบการดีบักและการพัฒนาโครงการ
เบต้า : การสูญเสียข้อมูลที่สำคัญทั้งหมดและข้อบกพร่องด้านความปลอดภัยได้รับการแก้ไขแล้ว หากโมดูลมี API ก็ควรถูกพิจารณาว่าเป็นน้ำแข็งเพื่อให้ผู้ใช้ API สามารถเริ่มอัพเกรดโครงการของพวกเขาได้ หากเป็นการอัพเกรดหรืออัปเดตของโครงการควรมีการเสนอพา ธ การอัปเดต / อัปเดตและผู้ใช้ปัจจุบันสามารถอัพเกรด / อัปเดตเป็นเวอร์ชันใหม่ได้โดยไม่สูญเสียข้อมูล เอกสารทั้งหมดควรเป็นข้อมูลล่าสุด กลุ่มเป้าหมายคือนักพัฒนาที่ต้องการมีส่วนร่วมในการทดสอบการดีบักและการพัฒนาโครงการและผู้พัฒนาโครงการอื่น ๆ ที่เชื่อมต่อโครงการ โดยทั่วไปไม่เหมาะสำหรับไซต์การผลิต แต่อาจใช้ในบางไซต์การผลิตหากผู้ดูแลไซต์รู้โครงการดีและรู้ว่าจะจัดการกับปัญหาใด ๆ ที่เหลืออยู่
สตริง "dev" และ "เสถียร" ไม่ถูกต้องเป็นส่วนหนึ่งของแท็กเผยแพร่ แต่การเผยแพร่การพัฒนาที่ไม่ได้ติดแท็กจะถือว่าเป็น "dev" และได้รับคำอธิบายเช่น "7.x-1.x-dev" โดย Drupal .org ปล่อยระบบบรรจุภัณฑ์เพื่อระบุว่าเป็นผลิตภัณฑ์ที่ไม่ได้ติดแท็กเพื่อการพัฒนา
แท็กปล่อยทั้งหมดจะต้องลงท้ายด้วยตัวเลข ตัวเลขเป็นเพียงการแยกความแตกต่างของชั้นเรียนเดียวกัน ตัวแรกคือหมายเลข "1" (ดังใน "alpha1") ตัวถัดไป "2" และอื่น ๆ
PS สตริงที่แสดงถึงการเผยแพร่ (เช่น "7.x-1.0-alpha4") เป็นที่รู้จักกันในชื่อ "แท็กปล่อย" ในสำนวน git ไม่ใช่ "ชื่อ" และคุณไม่เคยใช้รุ่นรองของ drupal เป็นส่วนหนึ่งของแท็กคุณใช้ "x" แทน