จากหน้าเอกสารสู่ความหมายที่ใช้ซ้ำได้
คงเอกสารทางเทคนิคที่อ่านง่าย ขณะที่แนวคิดสำคัญได้รับอัตลักษณ์ที่คงที่ การอ้างอิง เวอร์ชัน และการตรวจทานเชิงความหมาย
เหตุใดจึงเลือก Topoloom
เมื่อ Service เปลี่ยน ต้องรู้ว่าควรตรวจอะไร
เขียนเอกสารและไดอะแกรมที่อ่านง่ายต่อไป ใช้ออบเจ็กต์ร่วมสำหรับข้อเท็จจริงที่ต้องใช้ซ้ำหรือตรวจทาน รีโพซิทอรีและระบบมอนิเตอร์ยังคงมีอำนาจเหนือหลักฐานที่ตนครอบครอง
คำถามของเวิร์กโฟลว์ปัจจุบันเมื่อใช้ Topoloom
01
เจ้าของถูกระบุซ้ำไว้ที่ใดบ้าง
→ตรวจการอ้างอิงที่คงที่02
ลูกศรใดมีความหมาย
→ประกาศความสัมพันธ์แบบมีชนิด03
ผู้ตรวจทานมองเห็นอะไร
→เปรียบเทียบการเปลี่ยนแปลงเชิงความหมาย04
ตรวจกฎเมื่อใด
→กำกับการเผยแพร่05
ติดป้ายหลักฐานภายนอกอย่างไร
→ระบุแหล่งที่มาของบริบทผู้ให้บริการ06
อะไรอยู่รอดหลังการส่งออก
→ตรวจแพ็กเกจแบบกำหนดขอบเขตเลือกการเปลี่ยนแปลงหนึ่งรายการ · เปรียบเทียบทั้งสองเวิร์กโฟลว์
ความแตกต่างในทางปฏิบัติ
ใช้การเปลี่ยนแปลงของ Service หนึ่งรายการ เปรียบเทียบงานที่เกิดขึ้น
ทดสอบการเปลี่ยนเจ้าของหรือความสัมพันธ์การพึ่งพาในเวิร์กโฟลว์ปัจจุบันและใน Topoloom นับจำนวนการอัปเดต ขั้นตอนการตรวจทาน และงานส่งออกที่แต่ละวิธีต้องใช้
| คำถามของเวิร์กโฟลว์ปัจจุบัน | เมื่อใช้ Topoloom | สิ่งที่ต้องตรวจ |
|---|---|---|
| ปัจจุบันบันทึกเจ้าของคนนี้ไว้ที่ใด | อ้างอิงออบเจ็กต์ Service หนึ่งรายการ | การอัปเดตเจ้าของสร้าง object version ใหม่ Used in แสดงการอ้างอิงใน artifact version แบบแก้ไขไม่ได้ที่ได้รับอนุญาต ไม่ใช่ฉบับร่างที่กำลังแก้ไข |
| ลิงก์ใดในไดอะแกรมมีความหมาย | ประกาศความสัมพันธ์ที่สำคัญ | ขอบแบบมีชนิดเก็บบริบทของต้นทาง ปลายทาง ที่มา วงจรชีวิต และเวอร์ชันไว้ ตัวเชื่อมเชิงภาพยังคงแยกต่างหาก |
| ผู้ตรวจทานต้องอนุมานอะไร | ตรวจการเปลี่ยนแปลงเชิงความหมาย | เปรียบเทียบการเปลี่ยนเจ้าของ ความสัมพันธ์การพึ่งพา SLO, Decision และวงจรชีวิตควบคู่กับการแก้ข้อความหรือไดอะแกรม |
| กฎการเผยแพร่ทำงานเมื่อใด | ใช้ contract Service Overview ที่มีมาให้ | ฉบับร่างที่ยังไม่สมบูรณ์ยังแก้ไขได้ การตรวจสอบและการตรวจทานทำงานเมื่อเผยแพร่แบบมีการกำกับ |
| ติดป้ายหลักฐานภายนอกอย่างไร | คงการระบุแหล่งที่มาของบริบทผู้ให้บริการ | เมื่อกำหนดผู้ให้บริการที่รองรับ ข้อมูลที่พบยังคงแยกจากกันจนกว่ามนุษย์จะยอมรับการเปลี่ยนแปลงที่มนุษย์จัดทำ |
| ทีมตรวจอะไรได้หลังส่งออก | เปิดแพ็กเกจแบบกำหนดขอบเขต | ตรวจ artifact ที่อ่านได้ ID ที่คงที่ เวอร์ชัน ความสัมพันธ์ ที่มา บันทึกการตรวจทาน การแมป และรายงานส่วนที่ละไว้ |
ออบเจ็กต์เดียวที่ตรวจสอบได้
ข้อมูลผู้รับผิดชอบผูกกับ Service
อ้างอิง Service เดียวกันในเอกสารและไดอะแกรม รายละเอียดและเวอร์ชันออบเจ็กต์ที่แก้ไขไม่ได้ช่วยให้ตรวจสอบประวัติของตัวตนที่ใช้ร่วมกันนี้ได้
Used in แสดงการอ้างอิงที่มีสิทธิ์เข้าถึงในเวอร์ชันชิ้นงานที่แก้ไขไม่ได้ ไม่ใช่จำนวนของร่างที่กำลังแก้ไขทั้งหมด
การตรวจทานเชิงความหมาย
ดูว่าความหมายเปลี่ยนไปอย่างไร
เปรียบเทียบเวอร์ชันไดอะแกรมที่แก้ไขไม่ได้เพื่อตรวจสอบการเปลี่ยนแปลงการอ้างอิงออบเจ็กต์ที่ใช้ซ้ำได้ ภาพนี้เปรียบเทียบ Version 1 Baseline กับ Version 2 Current
เข้ากับระบบนิเวศวิศวกรรม
เสริมทุกระบบ โดยไม่สับสนเรื่องอำนาจของระบบใด
Topoloom ดูแลการจัดทำร่วมกันและ Document Graph ที่คนใช้เป็นหลัก รีโพซิทอรี แค็ตตาล็อก Service, CMDB, ข้อมูล telemetry และผู้ให้บริการบริบทยังคงดูแลหลักฐานและความจริงเชิงปฏิบัติการที่เหมาะกับตน
จากรูปทรงสู่ความสัมพันธ์ที่ประกาศแล้ว
คงตัวเชื่อมเชิงภาพไว้เมื่อเพียงพอ ยกระดับเฉพาะขอบที่ควรกำกับความหมาย
เชื่อมการตัดสินใจกับบริบทการพัฒนา
อ้างอิงตำแหน่งในซอร์สโค้ดและการตัดสินใจ โดยไม่เสนอว่าความรู้ที่มนุษย์จัดทำคือความจริงของระบบขณะทำงานหรือของโค้ด
วางหลักฐานไว้ข้างคำประกาศ
เมื่อกำหนดผู้ให้บริการที่รองรับ Topoloom เชื่อมถึงผ่าน contract สาธารณะและเก็บ identifier ของผู้ให้บริการไว้เป็นตัวอ้างอิงที่ไม่ตีความ ความแตกต่างที่ผู้ให้บริการรายงานจะแสดงเป็นบริบทให้คนตรวจได้ สิ่งที่มีให้ใช้ขึ้นกับผู้ให้บริการและการติดตั้ง
ตารางวัดผลเพื่อการตัดสินใจ
วัดวงจร ไม่ใช่จำนวนหน้า
เปรียบเทียบการเปลี่ยนแปลงของ Service เดียวกันในเวิร์กโฟลว์ปัจจุบันและใน Topoloom รวมการเตรียมงาน การอัปเดตครั้งที่สอง การตรวจทาน และความพยายามในการส่งออก
- 01เวลาตรวจทานการเปลี่ยนแปลงเวลาก่อนและหลัง
ผู้ตรวจทานต้องใช้เวลานานเท่าไรเพื่อเข้าใจการเปลี่ยนเจ้าของ ความสัมพันธ์การพึ่งพา SLO หรือ Decision
- 02การแก้ไขซ้ำจำนวนการอัปเดตต่อการเปลี่ยนแปลง
เมื่อ Service เดียวกันเปลี่ยน มีจุดใดบ้างที่ต้องอัปเดตด้วยมือ
- 03ความครอบคลุมของเจ้าของช่องว่างที่พบในแต่ละเวิร์กโฟลว์
Service ใดมีเจ้าของที่ประกาศไว้และที่มาที่ตรวจทานได้
- 04ความครอบคลุมของ Runbook / SLOพบหรือไม่พบความสัมพันธ์
Service ใดเชื่อมกับความรู้ที่ใช้ดูแลและวัดผล
- 05การดูแลโมเดลความพยายามในการตั้งค่าและติดตามผล
ทีมใช้เวลาเท่าไรในการสร้างการอ้างอิงและดูแลโมเดลระหว่างการอัปเดตครั้งที่สอง
- 06ขอบเขตการส่งออกสิ่งที่มีอยู่ในการส่งออก
ทีมตรวจระเบียนที่รวมอยู่และส่วนที่ละไว้โดยชัดเจนนอกผลิตภัณฑ์ได้หรือไม่
ประเมินความแตกต่าง
นำข้อเท็จจริงที่คัดลอกมาหนึ่งรายการ ทดสอบว่าออบเจ็กต์ร่วมลดงานซ้ำได้หรือไม่
เปรียบเทียบการเปลี่ยนเจ้าของหรือความสัมพันธ์การพึ่งพากับเวิร์กโฟลว์ปัจจุบัน บันทึกว่าแต่ละวิธีช่วยตรงไหนและเพิ่มงานตรงไหน