การแสดงตัวอย่าง WYSIWYG Markdown สำหรับความแตกต่างของคำขอการดึง Bitbucket
Bitbucket Rich Diffs โดย Zoran Jambor ช่วยเพิ่มการตรวจสอบโค้ดบน Bitbucket Cloud โดยการแปลง Markdown diffs ดิบให้เป็นการแสดงตัวอย่างที่เรนเดอร์ภายในคำขอการดึง ส่วนขยายจะแสดงองค์ประกอบที่จัดรูปแบบ เช่น หัวเรื่อง รายการ และตาราง และให้การเปลี่ยนมุมมองระหว่างการเรนเดอร์และแหล่งที่มา การติดตั้งไม่ต้องการการกำหนดค่า และทำงานใน Chrome และเบราว์เซอร์ที่ใช้ Chromium อื่น ๆ มันมุ่งเป้าไปที่วิศวกรซอฟต์แวร์ นักเขียนเทคนิค และผู้ดูแลโครงการที่ตรวจสอบเอกสาร Markdown และต้องการความเข้าใจที่รวดเร็วขึ้นในระหว่างการตรวจสอบคำขอการดึง
มันช่วยปรับปรุงความชัดเจนสำหรับผู้ตรวจสอบเอกสารอย่างไร ส่วนขยายนี้ให้มุมมอง WYSIWYG ของ Markdown ภายในคำขอการรวม ซึ่งลดความจำเป็นในการแยกวิเคราะห์ตัวบ่งชี้ความแตกต่างดิบ ผู้ตรวจสอบเห็นหัวข้อ รายการ และลิงก์ที่จัดรูปแบบในบริบท และการเปรียบเทียบภาพเน้นการเพิ่มและการลบภายในเนื้อหาที่จัดรูปแบบ การนำเสนอเช่นนี้ช่วยลดภาระทางปัญญาเมื่อเปรียบเทียบเวอร์ชันของ README หรือวิกิ โดยเฉพาะอย่างยิ่งในการเปลี่ยนแปลงเอกสารขนาดใหญ่ที่การอ่าน Markdown ดิบใช้เวลานาน
มันฝังอยู่ในอินเทอร์เฟซคำขอการรวมอย่างไร ภายในคำขอการรวม ส่วนขยายจะใส่การควบคุมสลับหรือแท็บลงในส่วนหัวความแตกต่างของแต่ละไฟล์เพื่อให้ผู้ตรวจสอบสามารถเปลี่ยนมุมมองได้โดยไม่ต้องออกจากหน้า มันรวมเข้ากับอินเทอร์เฟซพื้นเมืองของ Bitbucket แทนที่จะเปิดผู้ดูแยกต่างหาก ทำให้การนำทางและความคิดเห็นอยู่ในบริบทเดียวกัน การวางตำแหน่งเช่นนี้รักษากระบวนการตรวจสอบมาตรฐานและลดการเปลี่ยนบริบทในระหว่างรอบการตรวจสอบซ้ำ
ส่วนขยายนี้ทำอะไรเกี่ยวกับความเป็นส่วนตัวและขอบเขตของแพลตฟอร์ม ส่วนขยายนี้ต้องการสิทธิ์ในการอ่านข้อมูลบน bitbucket.org ดังนั้นการเรนเดอร์จึงเกิดขึ้นในเครื่องของคุณในเบราว์เซอร์ และเอกสารระบุว่าโดยทั่วไปจะไม่ส่งโค้ดไปยังเซิร์ฟเวอร์ภายนอก มันถูกออกแบบมาสำหรับ Bitbucket Cloud และไม่ได้ปรับให้เหมาะสมสำหรับการติดตั้ง Server หรือ Data Center การมุ่งเน้นไปที่แพลตฟอร์มนี้ทำให้มันมีประโยชน์สำหรับเวิร์กโฟลว์เอกสารที่โฮสต์ในคลาวด์ แต่จำกัดการใช้งานสำหรับที่เก็บข้อมูลในสถานที่
ใครได้รับประโยชน์มากที่สุดและที่ไหนที่มันยังคงเป็นเครื่องมือเฉพาะทาง วิศวกรซอฟต์แวร์ นักเขียนเทคนิค และผู้ดูแลที่เก็บข้อมูลได้รับประโยชน์มากที่สุดเพราะเครื่องมือนี้มุ่งเป้าไปที่การตรวจสอบเอกสารมากกว่าความแตกต่างของโค้ดทั่วไป นักพัฒนาคือผู้สร้างอิสระที่เป็นที่รู้จักในด้านยูทิลิตี้การทำงาน และข้อเสนอแนะแบบชุมชนทำให้ส่วนขยายนี้เป็นการเพิ่มเติมที่มีประโยชน์และเฉพาะทางสำหรับ Bitbucket Cloud มันยังทำงานบนเบราว์เซอร์ที่ใช้ Chromium ดังนั้นทีมที่ใช้ Chrome, Edge, Brave หรือ Vivaldi สามารถนำไปใช้ได้โดยไม่ต้องเปลี่ยนเบราว์เซอร์
ตัวเลือกที่เหมาะสมสำหรับผู้ตรวจสอบที่มุ่งเน้นเอกสาร ส่วนขยายนี้เป็นตัวเลือกที่มีเหตุผลสำหรับผู้ตรวจสอบและผู้เขียนที่ให้ความสำคัญกับการเปรียบเทียบ Markdown ที่ชัดเจนและมีรูปแบบ ซึ่งได้รับการอนุมัติจากชุมชนและการดูแลโดยนักพัฒนาคนเดียว ขอบเขตที่แคบของมันเหมาะสำหรับการทำงานที่มีเอกสารมากกว่าท่อการตรวจสอบโค้ดทั้งหมด ดังนั้นจึงควรนำไปใช้ควบคู่กับเครื่องมือการตรวจสอบโค้ดมาตรฐาน เคล็ดลับ: เปิดใช้งานเมื่อทำการตรวจสอบการเปลี่ยนแปลง README หรือ wiki เพื่อลดเวลาในการตีความความแตกต่างดิบ.
ข้อดี แสดงตัวอย่าง Markdown ที่เรนเดอร์โดยตรงภายในความแตกต่างของการดึงคำขอ สลับระหว่างมุมมองที่เรนเดอร์และแหล่งข้อมูลดิบในส่วนหัวของความแตกต่าง การเปรียบเทียบภาพจะเน้นการเพิ่มและการลบในเนื้อหาที่จัดรูปแบบ ทำงานบน Chrome และเบราว์เซอร์ที่ใช้ Chromium เป็นพื้นฐานอื่น ๆ ข้อเสีย จำกัดเฉพาะไฟล์ Markdown เท่านั้น ไม่รวมรูปแบบ markup หรือรูปแบบไบนารีอื่น ๆ ปรับให้เหมาะสมสำหรับ Bitbucket Cloud; อาจไม่รองรับเซิร์ฟเวอร์ในสถานที่ ต้องการสิทธิ์ในการอ่านหน้า bitbucket.org สำหรับการเรนเดอร์ในท้องถิ่น