เมื่อทีมผลิตภัณฑ์เปลี่ยนและวิศวกรใหม่เข้ามา สัญญาที่ไม่มีตัวอย่างและรายการตรวจจะกลายเป็นไฟล์ที่ไม่มีใครเชื่อ ควรเขียนสิ่งที่ต้องคงที่: ชื่อฟิลด์หลัก รหัสข้อผิดพลาดที่ธุรกิจอ่านได้ และกฎการเลิกใช้เวอร์ชัน
อย่าใส่ทุกแนวปฏิบัติที่ดีไว้ในเอกสารเดียว แยกคู่มือสั้นกับตัวอย่างที่ทีมคัดลอกได้ และทบทวนเมื่อมีเส้นทางธุรกิจใหม่ที่สำคัญ
บริการมาตรฐานและสัญญา API ของเรามุ่งให้ทีมใช้งานเองได้ ไม่ใช่พึ่งที่ปรึกษาทุกครั้งที่มี endpoint ใหม่