साइट के पब्लिशिंग प्लेटफॉर्म पर चलाए गए एक क्लीनअप स्क्रिप्ट ने गलती से कोड स्निपेट्स को त्रुटिपूर्ण Liquid वेरिएबल्स के रूप में पहचान लिया और उन्हें उन सभी लेखों से हटा दिया जिनमें वे मौजूद थे। इस गड़बड़ी के कारण दर्जनों तकनीकी पोस्ट उन उदाहरण कोड के बिना रह गए जिन पर पाठक भरोसा करते हैं, जिससे तत्काल रोलबैक और कंटेंट माइग्रेशन के परीक्षण के तरीकों पर पुनर्विचार करने की आवश्यकता पैदा हो गई।
यह बग कैसे निकल गया
यह प्लेटफॉर्म Liquid का उपयोग करता है, जो एक टेम्पलेटिंग भाषा है और {{ … }} जैसे टैग्स के साथ डायनेमिक कंटेंट को मार्क करती है। एक नियमित रखरखाव कार्य (routine maintenance job) का उद्देश्य उन भटके हुए टैग्स को हटाना था जो रेंडरिंग को खराब कर सकते थे। स्क्रिप्ट के पार्सर ने ऐसे ओपनिंग टैग्स की तलाश की जिनके साथ कोई मैचिंग क्लोजिंग टैग नहीं था, और जब उसे ऐसा कोई टैग मिला, तो उसने त्रुटि को "ठीक" करने के लिए पूरे ब्लॉक को ही डिलीट कर दिया।
व्यवहार में, पार्सर {% raw %} और {% endraw %} टैग्स को पहचानने में विफल रहा जो कोड ब्लॉक्स को रैप करते हैं। वे टैग्स Liquid को निर्देश देते हैं कि अंदर की हर चीज़ को लिटरल टेक्स्ट के रूप में माना जाए, लेकिन बग वाले स्क्रिप्ट ने ओपनिंग {% raw %} को एक अनक्लोज्ड वेरिएबल ({{% raw %}) के रूप में माना और आसपास के कोड को हटा दिया। लॉग किया गया एरर मैसेज था:
Liquid syntax error: Variable '{{% raw %}' was not properly terminated.
क्योंकि स्क्रिप्ट लाइव कंटेंट रिपॉजिटरी पर काम कर रही थी, इसलिए यह हटाना बड़े पैमाने पर हुआ, जिससे एक ही बार में सभी प्रभावित लेखों से कोड उदाहरण मिट गए।
क्या दांव पर है
तकनीकी लेख अवधारणाओं को समझाने, परिणामों को दोहराने और पाठकों को चरण-दर-चरण प्रक्रियाओं के माध्यम से मार्गदर्शन करने के लिए कोड स्निपेट्स पर निर्भर करते हैं। उन ब्लॉक्स के खो जाने से पोस्ट काफी हद तक बेकार हो जाते हैं, लेखकों को कंटेंट फिर से लिखने के लिए मजबूर होना पड़ता है, और प्लेटफॉर्म की विश्वसनीयता पर भरोसा कम होता है। एक ऐसी साइट के लिए जो उच्च गुणवत्ता वाले डेवलपर डॉक्यूमेंटेशन के आधार पर अपनी प्रतिष्ठा बनाती है, यह घटना पाठक संख्या और योगदानकर्ताओं के विश्वास दोनों के लिए खतरा है।
वे विवरण जो अधिकांश पाठक मिस कर देते हैं
- सैंडबॉक्सिंग के बिना बैच प्रोसेसिंग – स्क्रिप्ट को स्टेजिंग कॉपी के बजाय सीधे प्रोडक्शन डेटा पर चलाया गया था।
- अपर्याप्त टैग हैंडलिंग – केवल Liquid टैग्स के एक हिस्से को ही ध्यान में रखा गया था;
{% raw %}को व्हाइटलिस्ट से बाहर रखा गया था। - इंक्रीमेंटल टेस्टिंग की कमी – कार्य को छोटे सैंपल पर पायलट रन किए बिना पूरे डेटासेट पर लागू कर दिया गया था।
इसे क्या रोक सकता था
- कॉपी पर माइग्रेशन चलाएं – किसी भी बल्क ट्रांसफॉर्मेशन को पहले डेटाबेस के सैंडबॉक्स संस्करण पर लागू करें।
- सभी टैग वेरिएशन्स के खिलाफ पार्सर्स का यूनिट-टेस्ट करें – इसमें रॉ ब्लॉक्स, कमेंट टैग्स और नेस्टेड स्ट्रक्चर्स जैसे एज केस शामिल करें।
- क्रमिक रोलआउट (Gradual rollout) – सीमित संख्या में लेखों को प्रोसेस करें, परिणामों को सत्यापित करें, और फिर स्केल अप करें।
प्रति-तर्क
कुछ लोगों का तर्क है कि तेजी से चलने वाली साइटों के लिए फुल बैकअप पर हर स्क्रिप्ट का परीक्षण करना अव्यावहारिक है, और डेटा हानि का जोखिम त्वरित सुधारों की आवश्यकता की तुलना में कम है। हालांकि गति मायने रखती है, लेकिन बड़े पैमाने पर डिलीशन को उलटने की लागत – डेवलपर के समय और प्रतिष्ठा के नुकसान, दोनों के संदर्भ में – अक्सर सतर्क रोलआउट के कारण होने वाली देरी से कहीं अधिक होती है।
आगे क्या देखने की आवश्यकता है
टीम ने बैकअप से गायब कोड को बहाल कर दिया है और सभी Liquid कंस्ट्रक्ट्स को पहचानने के लिए क्लीनअप टूल में संशोधन कर रही है। वे अपडेटेड टेस्टिंग वर्कफ़्लो का विवरण देते हुए एक पोस्ट-मॉर्टम प्रकाशित करने और संशोधित स्क्रिप्ट को सार्वजनिक रूप से साझा करने की योजना बना रहे हैं ताकि अन्य प्रकाशक भी उसी गलती से बच सकें। यह घटना एक अनुस्मारक के रूप में कार्य करती है: एक छोटी सी पार्सिंग त्रुटि भी लेखक के हफ्तों के प्रयास को मिटा सकती है, जिससे कठोर परीक्षण अनिवार्य हो जाता है।