บันทึกการเปลี่ยนแปลง
บันทึกการเปลี่ยนแปลง
หัวข้อที่มีชื่อว่า “บันทึกการเปลี่ยนแปลง”ระบบนิเวศ NextPDF ครอบคลุมแพ็กเกจและรีโพซิทอรีจำนวนมาก หน้านี้แสดงวิธีบันทึกการเปลี่ยนแปลงของระบบนิเวศ และตำแหน่งที่แต่ละแพ็กเกจจัดเก็บบันทึกการเปลี่ยนแปลงของตนเอง ใช้หน้านี้เป็นดัชนีและเอกสารอ้างอิงเชิงข้อกำหนด ไม่ใช่รายการซ้ำของทุกคอมมิต แต่ละแพ็กเกจจัดเก็บบันทึกการเปลี่ยนแปลงที่เผยแพร่แล้วซึ่งเป็นฉบับอ้างอิงไว้ในรีโพซิทอรีของตนเอง ตารางสรุปนี้รวบรวมเฉพาะ หมวดหมู่ของการเปลี่ยนแปลงต่อเวอร์ชันที่เผยแพร่ ซึ่งดึงมาจากประวัติ Conventional Commits ของแต่ละรีโพซิทอรี
ในฐานะดัชนีเอกสาร หน้านี้ไม่ได้กล่าวอ้างใดๆ เกี่ยวกับพฤติกรรมของแพ็กเกจใด หากต้องการดูกฎที่แต่ละแพ็กเกจปฏิบัติตามเมื่อเขียนคอมมิตและออกรุ่น โปรดดู ข้อกำหนดของบันทึกการเปลี่ยนแปลง ประกอบ
วิธีบันทึกการเปลี่ยนแปลง
หัวข้อที่มีชื่อว่า “วิธีบันทึกการเปลี่ยนแปลง”รีโพซิทอรีสาธารณะทุกแห่งของ NextPDF ปฏิบัติตามข้อตกลงสองชุด:
- Conventional Commits 1.0.0 — หัวข้อของแต่ละคอมมิตใช้รูปแบบ
type(scope): descriptionโดยที่typeเป็นหนึ่งในfeat,fix,perf,refactor,docs,test,build,ci,choreหรือrevertเครื่องหมาย!หลัง type/scope หรือฟุตเตอร์BREAKING CHANGE:บ่งชี้การเปลี่ยนแปลงที่เข้ากันไม่ได้ การแก้ไขที่เกี่ยวข้องกับความปลอดภัยจะมีป้ายกำกับเพื่อให้กรองได้ - Semantic Versioning 2.0.0 —
featจะปรับเพิ่มเวอร์ชันรองfix/perfจะปรับเพิ่มเวอร์ชันแพตช์ และการเปลี่ยนแปลงที่ทำให้เข้ากันไม่ได้จะปรับเพิ่มเวอร์ชันหลัก ไฟล์CHANGELOG.mdที่เผยแพร่แล้วในแต่ละรีโพซิทอรีจัดกลุ่มรายการที่ผู้อ่านเข้าใจได้ตามเวอร์ชัน โดยใช้ Keep a Changelog เป็นแนวทางการแบ่งส่วน
สรุปด้านล่างครอบคลุมเฉพาะหมวดหมู่ที่ ผู้ใช้มองเห็น เท่านั้น: feat (ความสามารถใหม่), fix (พฤติกรรมที่แก้ไขแล้ว), perf (ประสิทธิภาพ), security (การแก้ไขที่เกี่ยวข้องกับความปลอดภัย) และการเปลี่ยนแปลงที่ทำให้เข้ากันไม่ได้ ประเภทคอมมิตที่ใช้ภายในเท่านั้น (docs, test, ci, chore, refactor) ถูกละไว้จากสรุปข้ามรีโพซิทอรีโดยเจตนา ประเภทเหล่านี้ไม่เปลี่ยนสิ่งที่คุณสังเกตได้เมื่อใช้งานแพ็กเกจ
ตำแหน่งที่จัดเก็บบันทึกการเปลี่ยนแปลงของแต่ละแพ็กเกจ
หัวข้อที่มีชื่อว่า “ตำแหน่งที่จัดเก็บบันทึกการเปลี่ยนแปลงของแต่ละแพ็กเกจ”บันทึกการเปลี่ยนแปลงฉบับอ้างอิงในรูปแบบร้อยแก้วของแพ็กเกจคือไฟล์ CHANGELOG.md ในรีโพซิทอรีของแพ็กเกจนั้นเอง โดยจัดกลุ่มตามเวอร์ชันที่เผยแพร่ สำหรับข้อความของรายการฉบับเต็ม โปรดใช้หน้ารุ่นของรีโพซิทอรีหรือไฟล์ CHANGELOG.md ดัชนีนี้ไม่ได้ทำซ้ำข้อความดังกล่าว
| แพ็กเกจ | รีโพซิทอรี | บันทึกการเปลี่ยนแปลงฉบับอ้างอิง |
|---|---|---|
nextpdf/core | nextpdf | CHANGELOG.md (Keep a Changelog) |
nextpdf/server | nextpdf-server | CHANGELOG.md |
nextpdf/laravel | nextpdf-Laravel | CHANGELOG.md |
nextpdf/symfony | nextpdf-Symfony | CHANGELOG.md |
nextpdf/codeigniter | nextpdf-CodeIgniter | CHANGELOG.md |
nextpdf/artisan | nextpdf-Artisan | CHANGELOG.md |
nextpdf/gotenberg | nextpdf-Gotenberg | CHANGELOG.md |
nextpdf/cloudflare | nextpdf-Cloudflare | CHANGELOG.md |
nextpdf/compat-legacy | nextpdf-compat-tcpdf | CHANGELOG.md |
nextpdf (Python bindings) | nextpdf-python | CHANGELOG.md |
สรุปข้ามรีโพซิทอรี — หมวดหมู่ต่อเวอร์ชันที่เผยแพร่ล่าสุด
หัวข้อที่มีชื่อว่า “สรุปข้ามรีโพซิทอรี — หมวดหมู่ต่อเวอร์ชันที่เผยแพร่ล่าสุด”ตารางอ่านอย่างเดียวนี้สร้างจากประวัติ Conventional Commits ของแต่ละรีโพซิทอรี ณ แท็กที่เผยแพร่ล่าสุด ตารางนี้นับหมวดหมู่ที่ผู้ใช้มองเห็นและรายงาน เฉพาะจำนวนตามหมวดหมู่ เท่านั้น — ไม่เคยแสดงหัวข้อคอมมิตดิบ — จึงไม่เปิดเผยตัวระบุภายใน ชื่อสาขา หรือการอ้างอิงเชิงวางแผน สำหรับรายละเอียดเชิงร้อยแก้วของแต่ละบรรทัด โปรดดูไฟล์ CHANGELOG.md ของแพ็กเกจนั้นเอง
| แพ็กเกจ | เผยแพร่ล่าสุด | ความสามารถใหม่ (feat) | การแก้ไข (fix) | ประสิทธิภาพ (perf) | ความปลอดภัย | เข้ากันไม่ได้ |
|---|---|---|---|---|---|---|
nextpdf/core | v5.2.0 | 317 | 290 | 1 | 1 | ใช่ |
nextpdf/server | v0.1.0 | 15 | 16 | 0 | 0 | ไม่ |
nextpdf/laravel | v0.1.0 | 1 | 8 | 0 | 0 | ไม่ |
nextpdf/symfony | v0.1.0 | 1 | 7 | 0 | 0 | ไม่ |
nextpdf/codeigniter | v0.1.0 | 1 | 10 | 0 | 0 | ไม่ |
nextpdf/artisan | v0.1.0 | 1 | 7 | 0 | 0 | ไม่ |
nextpdf/gotenberg | v0.1.0 | 0 | 6 | 0 | 0 | ไม่ |
nextpdf/cloudflare | v0.1.0 | 0 | 8 | 0 | 0 | ไม่ |
nextpdf/compat-legacy | v0.1.0 | 1 | 8 | 0 | 0 | ไม่ |
nextpdf (Python) | v1.1.0 | 7 | 5 | 0 | 0 | ไม่ |
จำนวนที่นับเป็นยอดสะสมจนถึงแท็กที่ระบุ สำหรับแพ็กเกจการผสานรวมแต่ละแพ็กเกจ รุ่นแรกที่ติดแท็กจะรวมประวัติก่อนเวอร์ชัน 1.0 ทั้งหมดของแพ็กเกจนั้น เซลล์ “Breaking” ของ
nextpdf/coreแสดงค่าyesเนื่องจากเอนจินหลักเผยแพร่ เวอร์ชันหลักที่ทำให้เข้ากันไม่ได้แล้ว รายละเอียดรายเวอร์ชันและเส้นทางการย้ายระบบของแต่ละเวอร์ชัน มีอยู่ในไฟล์CHANGELOG.mdและคู่มือmigration/ในรีโพซิทอรีหลัก ดัชนีนี้ไม่ได้กล่าวซ้ำรายละเอียดเหล่านั้น
สิ่งที่หน้านี้จงใจละไว้
หัวข้อที่มีชื่อว่า “สิ่งที่หน้านี้จงใจละไว้”เพื่อให้บันทึกการเปลี่ยนแปลงสาธารณะไม่เปิดเผยข้อมูลภายใน ดัชนีนี้ไม่เคยแสดงสิ่งต่อไปนี้:
- หัวข้อหรือเนื้อความของคอมมิตดิบ
- ตัวระบุของปัญหา ทิกเก็ต รอบ เวฟ หรือรายการงานภายใน
- ชื่อสาขาส่วนตัวหรืองานที่ยังไม่เผยแพร่ซึ่งกำลังดำเนินการอยู่
- แผนงานหรือฟีเจอร์ที่ยังไม่ประกาศ
- การระบุที่มาของระบบอัตโนมัติของผู้มีส่วนร่วม
การเปลี่ยนแปลงจะแสดงที่นี่ก็ต่อเมื่อกลายเป็นส่วนหนึ่งของเวอร์ชันที่เผยแพร่และติดแท็กของแพ็กเกจสาธารณะแล้วเท่านั้น งานที่ยังไม่เผยแพร่จะไม่ปรากฏ