YAML और JSON: रूप नहीं, डेटा का अर्थ सुरक्षित रखें
YAML कॉन्फ़िगरेशन को किसी सेवा के लिए JSON में बदलना पड़ सकता है। संरचनाएँ मिलती दिखें तो भी मूल फ़ाइल की हर चीज़ का बराबर रूप नहीं होता।
दिखावट से अधिक प्रकार महत्वपूर्ण है
स्ट्रिंग "003" संख्या 3 नहीं है और उद्धरण में "false", बूलियन false नहीं है। पहचान-कोड में शुरुआती शून्य या सटीक लेखन मायने रखे तो उसे पाठ रखें।
कनवर्टर JSON-संगत YAML 1.2 Core डेटा संभालता है। पुरानी प्रणाली की धारणाएँ सीधे न लाएँ; किसी शब्द का अर्थ संस्करण के साथ बदल सकता है।
संदर्भ: YAML 1.2.2 — Core types and comments as presentation
टिप्पणी रखरखाव करने वाले के लिए है
YAML टिप्पणियाँ रखरखाव में मदद करती हैं, डेटा का भाग नहीं हैं। यहाँ वे JSON में नहीं जातीं और दोबारा YAML बनाने से नहीं लौटतीं।
टिप्पणी वाला स्रोत अलग रखें और परिणाम को डेटा निर्यात मानें। सिंटैक्स रंग या परिचित पंक्ति-क्रम सही प्रकार होने का प्रमाण नहीं है।
संदर्भ: YAML 1.2.2 — Core types and comments as presentation
असमर्थित चीज़ रोकने से चुपचाप नुकसान नहीं होता
यह प्रवाह पाठ-कुंजियों वाला एक दस्तावेज़ स्वीकार करता है। दोहरी कुंजियाँ, alias, anchor, custom tag और समर्थित मैपिंग के बाहर की सुविधाएँ अस्वीकार होती हैं।
प्रतिनिधित्व-सीमा के बाहर संख्याएँ चुपचाप गोल नहीं की जातीं, अस्वीकार होती हैं। लंबे पहचान-कोड पाठ में रखें। परिवर्तन कॉन्फ़िगरेशन चलाता या प्राप्तकर्ता सेवा की स्वीकृति सिद्ध नहीं करता।
उदाहरण: अलग प्रकारों के तीन मान
code: "003", enabled: false और retries: 3 से स्ट्रिंग "003", बूलियन false और संख्या 3 मिलती हैं। शून्य इसलिए बचते हैं क्योंकि code पाठ है, पहचान-कोड होने का अनुमान लगाने से नहीं।
पहले # staging जोड़ने से JSON गुण नहीं बनता। वापस YAML में उद्धरण और रूप बदल सकते हैं जबकि प्रकार व मान बराबर रहते हैं; मूल टिप्पणी वापस नहीं आती।